IEnumMediaTypes::Next
A version of this page is also available for
4/8/2010
This method retrieves the specified number of items in the enumeration sequence.
Syntax
HRESULT Next(
ULONG cMediaTypes,
AM_MEDIA_TYPE** ppMediaTypes,
ULONG* pcFetched
);
Parameters
- cMediaTypes
[in] Number of media types to place.
- ppMediaTypes
[out] Array in which to place the pointers to the next media type.
- pcFetched
[out] Actual count passed.
Return Value
Returns an HRESULT value that depends on the implementation.
HRESULT can be one of the following standard constants or other values not listed.
| Value | Description |
|---|---|
E_FAIL |
Failure. |
E_POINTER |
Null pointer argument. |
E_INVALIDARG |
Invalid argument. |
E_NOTIMPL |
Method is not supported. |
S_OK or NOERROR |
Success. |
Remarks
To use this method, pass an array of pointers to media types.
If you want only a single media type, you can pass a pointer to a media type pointer in place of an array of media type pointers.
The interface allocates the necessary AM_MEDIA_TYPE structures and initializes them with the variable format block.
Free each media type by calling DeleteMediaType, which will free the format block and the media type itself.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |