IPortableDeviceCapabilities::GetSupportedFormats method (portabledeviceapi.h)

The GetSupportedFormats method retrieves the supported formats for a specified object type on the device. For example, specifying audio objects might return WPD_OBJECT_FORMAT_WMA, WPD_OBJECT_FORMAT_WAV, and WPD_OBJECT_FORMAT_MP3.

Syntax

HRESULT GetSupportedFormats(
  [in]  REFGUID                              ContentType,
  [out] IPortableDevicePropVariantCollection **ppFormats
);

Parameters

[in] ContentType

A REFGUID that specifies a content type, such as image, audio, or video. For a list of content types that are defined by Windows Portable Devices, see Requirements for Objects.

[out] ppFormats

Address of a variable that receives a pointer to an IPortableDevicePropVariantCollection interface that lists the supported formats for the specified content type. These are GUID values (type VT_CLSID) in the retrieved collection items. For a list of formats that are supported by Windows Portable Devices, see Object Formats. The caller must release this interface when it is done with it.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_POINTER
At least one of the arguments was a NULL pointer.

Requirements

Requirement Value
Target Platform Windows
Header portabledeviceapi.h
Library PortableDeviceGUIDs.lib

See also

IPortableDeviceCapabilities Interface

IPortableDeviceCapabilities::GetSupportedFormatProperties