MediaQueryEngine_t::OemExtensionUpnpQuery (Windows Embedded CE 6.0)

1/5/2010

The OemExtensionUpnpQuery method creates a new MediaQuery_t object for the specified container id, search string and sort criteria.

You should use this method only if the generic query function does not enable you to make a specific UPnP query.

Syntax

MediaQuery_t OemExtensionUpnpQuery (
  const WCHAR* pContainerIdStr,
  const WCHAR* pSearchString,
  const WCHAR* pSortString,
  int BatchSize
);

Parameters

• pContainerIdStr
  This is the container number for the query. The container number specifies the portion of media collection to search for. For example, container id 1 is for AllMusic, Container id 2 is AllVideo. For complete list see How to Build a Network Device Compatible with WMC.

• pSearchString
  You can filter the data based on file extension or property of media item data. For more information see How to Build a Network Device Compatible with WMC.

• pSortString
  You can sort the result based on any property of media item data. see How to Build a Network Device Compatible with WMC.

• BatchSize
  The number of media items in one batch.

Return Value

This method returns an MediaQuery_t object.

Remarks

Call IsValid on the returned media query to make sure the requested query was valid. If the returned MediaQuery_t object is not valid, call GetLastError to find out reason for the failure.

All strings must be less than s_MAX_INPUTSTRING (256 chars)

Requirements

See Also

Reference

MediaQueryEngine_t
MediaQuery_t