IAMVideoAccelerator::Execute

 
Microsoft DirectShow 9.0

IAMVideoAccelerator::Execute

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 elements in the pamvaBufferInfo array.

pamvaBufferInfo

[in] Pointer to an array of AMVABUFFERINFO structures.

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.

Requirements

Header: Include videoacc.h.

Library: Use Strmiids.lib.

See Also