MediaQuery_t::GetNextBatch (Windows CE 5.0)

2012-09-14

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.

Share via