MediaQuery_t::GetNextBatch (Windows Embedded CE 6.0)
1/5/2010
The GetNextBatch method retrieves the MediaItemBatch_t object for the requested batch number. The batch contains media items from CurrentItemOffset() to CurrentItemOffset() + min(BatchSize(), rest of available media items)
If the call is successful, the CurrentItemOffset is incremented by the returned MediaItemBatch_t. TotalItems().
Syntax
MediaItemBatch_t GetNextBatch ( none );
Parameters
None.
Return Value
This method returns the requested media items in a MediaItemBatch_t object. If the IsValid on returned MediaItemBatch_t is false, check GetLastError() to find reason for the failure.
In case of failure, the possible values returned by GetLastError() are:
| Last Error | Description |
|---|---|
ERROR_INVALID_STATE |
The query object on which the function is called is invalid. |
ERROR_EMPTY |
There is no more data available |
ERROR_DEVICE_NOT_CONNECTED |
The device is not connected |
ERROR_NOT_ENOUGH_MEMORY |
MediaQueryEngine was not able to allocate memory for the requested operation. |
UpnpErrorCode |
If the error code is none of the above, it is error code set by UPnP. Consult UPnP documentation. |
Remarks
None.
Requirements
| Header | mediaqueryengine.hpp |
| Library | MQELib.lib |
| Windows Embedded CE | Windows CE 5.0 Networked Media Device Feature Pack and later |