Microsoft DirectX 8.0 |
The IAMVideoProcAmp interface is implemented on the WDM Video Capture filter. The interface enables applications to adjust the qualities of the incoming video signal such as brightness, contrast, hue, saturation, gamma, and sharpness. It defines a uniform range for these settings regardless of whether the adjustment is made in the analog or digital domain.
Methods in Vtable Order
IUnknown methods Description QueryInterface Retrieves pointers to supported interfaces. AddRef Increments the reference count. Release Decrements the reference count. IAMVideoProcAmp methods Description GetRange Retrieves minimum, maximum, and default values for setting properties. Set Sets video quality for a specified property. Get Retrieves video quality for a specified property.
Retrieves video quality for a specified property.
Syntax
HRESULT Get(
long Property,
long *lValue,
long *Flags );
Parameters
- Property
- [in] Specific property to retrieve the setting of. Specify a member of the VideoProcAmpProperty enumerated type.
- lValue
- [out] Pointer to the current value of the property.
- Flags
- [out] Pointer to a member of the VideoProcAmpFlags enumerated type.
Return Value
Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.
E_FAIL Failure. E_POINTER Null pointer argument. E_INVALIDARG Invalid argument. E_NOTIMPL Method is not supported. NOERROR No error.
Retrieves minimum, maximum, and default values for setting properties.
Syntax
HRESULT GetRange(
long Property,
long *pMin,
long *pMax,
long *pSteppingDelta,
long *pDefault,
long *pCapsFlags );
Parameters
- Property
- [in] Specific property to determine the range of. Specify a member of the VideoProcAmpProperty enumerated type.
- pMin
- [out] Pointer to the minimum setting range.
- pMax
- [out] Pointer to the maximum setting range.
- pSteppingDelta
- [out] Pointer to the step size.
- pDefault
- [out] Pointer to the default value.
- pCapsFlags
- [out] Pointer to a member of the VideoProcAmpFlags enumerated type.
Return Value
Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.
E_FAIL Failure. E_POINTER Null pointer argument. E_INVALIDARG Invalid argument. E_NOTIMPL Method is not supported. NOERROR No error.
Sets video quality for a specified property.
Syntax
HRESULT Set(
long Property,
long lValue,
long Flags );
Parameters
- Property
- [in] Specific property to set. Specify a member of the VideoProcAmpProperty enumerated type.
- lValue
- [in] Value indicating the setting of the property.
- Flags
- [in] Member of the VideoProcAmpFlags enumerated type.
Return Value
Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.
E_FAIL Failure. E_INVALIDARG Invalid argument. E_NOTIMPL Method is not supported. NOERROR No error.