IltmmVideoFormats::Find
#include "ltmm.h"
|
C Syntax |
HRESULT IltmmVideoFormats_Find(pVideoFormats, SubType, Width, Height, Index) |
|
C++ Syntax |
HRESULT Find(pVideoFormats, SubType, Width, Height, Index) |
|
IltmmVideoFormats *pVideoFormats; |
/* pointer to an interface */ |
|
BSTR SubType; |
/* subtype format */ |
|
long Width; |
/* width */ |
|
long Height; |
/* height */ |
|
long *Index; |
/* pointer to a variable */ |
Retrieves the index of the video format that matches the specified criteria (subtype, width and height).
|
Parameter |
Description |
|
pVideoFormats |
Pointer to an IltmmVideoFormats Interface. |
|
SubType |
Character string that contains the video subtype format. For a list of possible values, refer to the Media Subtypes section of the Format Types, Media Types and Media Subtypes. |
|
Width |
The video width in pixels. |
|
Height |
The video height in pixels. |
|
Index |
Pointer to a variable that receives the zero based index of the matching video format. A value of –1 indicates that no match was found. |
Returns
|
S_OK |
The function was successful. |
|
<> S_OK |
An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation. |
Required DLLs and Libraries
|
LTMM For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
|
Elements: |
IltmmVideoFormats::get_Count, IltmmVideoFormats::Item, IltmmVideoFormats::get_Selection, IltmmVideoFormats::put_Selection |
|
Topics: |
Example
For a C example, refer to the IltmmVideoFormats::get_Count Example for C.
For a C++ example, refer to the IltmmVideoFormats::get_Count Example for C++.