IEnumDVD_XXXX::Next (Windows Embedded CE 6.0)
1/6/2010
This method retrieves a specified number of items in an enumeration sequence.
Syntax
HRESULT Next(
ULONG celt,
DVD_XXXX* rgelt,
ULONG* pceltFetched
);
Parameters
- celt
[in] Number of elements being requested.
rgelt
[out] Array of size celt (or larger) of the elements of interest.The type of this parameter depends on the item being enumerated and can be DVD_CELL_PIECE, DVD_TEXT_ITEM, or DVD_TEXT_LANGUAGE_UNIT.
- pceltFetched
[in, out] Pointer to the number of elements actually supplied in rgelt. The caller can pass in NULL if celt is one.
Return Value
This method returns the following values.
Value | Description |
---|---|
S_OK |
The number of elements supplied is celt. |
S_FALSE |
The number of elements supplied is not equal to celt. |
Remarks
If the request number of elements is greater than the number of elements left in the collection then this method retrieves the remaining elements.
The number of elements actually retrieved is returned through pceltFetched (unless the caller passed in NULL for that parameter).
Requirements
Header | dvdata.h, dvdata.idl |
Library | Ddvdids.lib |
Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
IEnumDVD_XXXX
IEnumDVD_CELL_PIECE
IEnumDVD_TEXT_ITEM
IEnumDVD_TEXT_LANGUAGE_UNIT
DVD_CELL_PIECE
DVD_TEXT_ITEM
DVD_TEXT_LANGUAGE_UNIT