IDirectDrawVideo::GetFourCCCodes

  • Articolo
 
Microsoft DirectShow 9.0

IDirectDrawVideo::GetFourCCCodes

The GetFourCCCodes method retrieves the multimedia format type.

Syntax

  HRESULT GetFourCCCodes(
  DWORD *pCount,
  DWORD *pCodes
);

Parameters

pCount

Pointer to the number of FOURCC codes in the pCodes array.

pCodes

Pointer to an array of DWORD media tags formerly used for Microsoft multimedia types.

Return Values

Returns an HRESULT value.

Remarks

In the original Microsoft® Windows® multimedia APIs, media types were tagged with 32-bit values created from four 8-bit characters and were known as FOURCC codes. Because FOURCC codes are unique, a one-to-one mapping has been made possible by allocating a range of 4 billion GUIDs representing FOURCCs.

This method retrieves the FOURCC codes that the current display driver can support. The number available is obtained by calling the method with a valid pCount pointer, but with pCodes set to NULL. In this case, the pCount variable will be filled in with the number of FOURCC codes available. An application can then allocate enough DWORD values for this many FOURCC codes and call the method again with the array pointer in pCodes.

Requirements

Header: Declared in Amvideo.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also