| Microsoft DirectX 8.1 (C++) |
The Execute method performs a decompression operation.
Syntax
HRESULT Execute(
DWORD dwFunction,
LPVOID lpPrivateInputData,
DWORD cbPrivateInputData,
LPVOID lpPrivateOutputData,
DWORD cbPrivateOutputData,
DWORD dwNumBuffers,
const AMVABUFFERINFO *pamvaBufferInfo
);
Parameters
dwFunction
[in] Function number. This can be zero if this argument is the default or is ignored.
lpPrivateInputData
[in] Pointer to private input data passed to the driver.
cbPrivateInputData
[in] Length of private input data.
lpPrivateOutputData
[in] Pointer to private output data passed to the driver.
cbPrivateOutputData
[in] Length of private data buffer.
dwNumBuffers
[in] Number of AMVABUFFERINFO structures.
pamvaBufferInfo
[in] Pointer to a list of AMVABUFFERINFO structures to be passed.
Return Values
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.
| Return code | Description |
| E_FAIL | Failure. |
| E_INVALIDARG | Argument is invalid. |
| E_NOTIMPL | Method is not supported. |
| E_POINTER | Null pointer argument. |
| S_OK | Success. |
Remarks
It is only valid to call this method after the pins are connected.
The associated buffer list is passed along with a function number (defaulting to zero) and any necessary private data describing the decompression operation. For example, decompressed reference frame information is passed in the buffer list. The buffer list order is important and is defined by the particular decompression operation being performed.
Private data can be passed to and from a driver.
See Also