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

See Also

Reference

MediaQuery_t