MediaQuery_t::GetNextBatch (Windows CE 5.0)

Send Feedback

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

MediaQuery_t

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.