IDirect3DVideoDevice9::GetUncompressedDXVAFormats method

Gets a list of uncompressed pixel formats that can be rendered using a specified DirectX Video Acceleration (DXVA) profile.

Syntax

HRESULT GetUncompressedDXVAFormats(
   GUID      *pGuid,
   DWORD     *pNumFormats,
   D3DFORMAT *pFormats
);

Parameters

pGuid

Pointer to a GUID that specifies the DXVA profile. To get a list of supported profiles, call IDirect3DVideoDevice9::GetDXVAGuids.

pNumFormats

On input, specifies the number of elements in the pFormats array. If pFormats is NULL, the value of *pNumFormats must be zero.

On output, if pFormats is NULL, pNumFormats receives the number of supported pixel formats. Otherwise, pNumFormats receives the actual number of pixel formats copied to the pFormats array.

pFormats

Address of an array of D3DFORMAT values, or NULL. If the value is non-NULL, the array receives a list of pixel formats.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Call this method twice. On the first call, set pFormats to NULL. The pNumFormats parameter receives the number of formats. Allocate a D3DFORMAT array with the required size, and call the method again. This time, set pFormats to the address of the array. The method fills the array with the list of pixel formats.

The driver should return the formats in decreasing order of preference, with the most preferred format listed first.

Requirements

See also

IDirect3DVideoDevice9