Microsoft DirectX 9.0 |
The Next method retrieves the next n elements in the collection.
Syntax
HRESULT Next(
ULONG cRequest,
PID_MAP* pPIDMap,
ULONG* pcReceived
);
Parameters
cRequest
[in] The number of elements to retrieve.
pPIDMap
[in, out] Address of an array allocated by the caller, containing cRequest elements. The array is filled with PID_MAP structures that describe the PID mapping.
pcReceived
[out] Pointer to a variable that receives the number of elements actually retrieved. This parameter cannot be NULL. If cRequest equals zero, this parameter receives the total number of items in the collection.
Return Values
Returns an HRESULT value. Possible values include the following.
Value | Description |
E_INVALIDARG | Invalid argument; pPidMap and pcReceived cannot be NULL. |
S_FALSE | Reached the end of the collection. |
S_OK | Success. |
See Also