MediaQuery_t::GetNextBatch (Windows CE 5.0)
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
OS Versions: Windows CE 5.0 Networked Media Device Feature Pack.
Header: MediaQueryEngine.hpp.
Link Library: MQELib.lib.
See Also
Send Feedback on this topic to the authors