Microsoft DirectX 8.1 (C++)

IAMVideoAcceleratorNotify::GetCreateVideoAcceleratorData

The GetCreateVideoAcceleratorData method retrieves the information needed to create a video accelerator object.

Syntax

HRESULT GetCreateVideoAcceleratorData(
  const GUID *pGuid,
  LPWDORD pdwSizeMiscData,
  LPVOID *ppMiscData
);

Parameters

pGuid

[in] Pointer to a GUID identifying the video accelerator.

pdwSizeMiscData

[out] Pointer to a variable that receives the size of the data returned in ppMiscData, in bytes.

ppMiscData

[out] Address to a pointer of type void that receives the miscellaneous data (or NULL if pdwSizeMiscData is 0). This pointer should be allocated with CoTaskMemAlloc, a helper function from the COM library. It is freed by the caller. See Remarks.

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

This method retrieves a pointer to any miscellaneous data that the video decoder needs to send to the video accelerator driver when the video accelerator is initialized. It is the caller's responsibility to call CoTaskMemFree on ppMiscData.

See Also