Microsoft DirectX 8.1 (C++)

CImageDisplay::CheckVideoType

Compares a video type to determine if it is compatible with the current display mode.

Syntax

HRESULT CheckVideoType(
    const VIDEOINFO *pInput
);

Parameters

pInput

Pointer to the VIDEOINFO structure to validate.

Return Value

Returns NOERROR if successful or E_INVALIDARG if unsuccessful.

Remarks

Many video rendering filters want a function to determine if proposed formats are okay. This member function checks the VIDEOINFO structure passed as a media type and returns NOERROR if the media type is valid; otherwise, it returns E_INVALIDARG434. Note, however, that only formats that can be easily displayed on the current display device are accepted; so, for example, a 16-bit device will not accept 24-bit images. Because most displays draw 8-bit palettized images efficiently, this format is always accepted unless the display is 16-color VGA.

See Also