IPortableDeviceServiceCapabilities::GetSupportedFormatProperties method (portabledeviceapi.h)

The GetSupportedFormatProperties method retrieves the properties supported by the service for the specified format.

Syntax

HRESULT GetSupportedFormatProperties(
  [in]  REFGUID                      Format,
  [out] IPortableDeviceKeyCollection **ppKeys
);

Parameters

[in] Format

The format whose properties are retrieved.

[out] ppKeys

The IPortableDeviceKeyCollection interface that receives the list of properties.

Return value

If the method succeeds, it returns S_OK. Any other HRESULT value indicates that the call failed.

Remarks

The retrieved property collection is a superset of all properties supported by an object of the specified format.

An application can also retrieve the properties for an object by calling the IPortableDeviceService::SendCommand method with the WPD_COMMAND_OBJECT_PROPERTIES_GET_SUPPORTED property passed as the command identifier. However, the GetSupportedFormatProperties method is typically faster than the IPortableDeviceService::SendCommand method.

Requirements

See also

IPortableDeviceServiceCapabilities Interface