Share via

IPortableDeviceCapabilities::GetFunctionalCategories

  • Article

banner art

Previous Next

IPortableDeviceCapabilities::GetFunctionalCategories

The GetFunctionalCategories method retrieves all functional categories supported by the device.

Syntax

  HRESULT GetFunctionalCategories(
  IPortableDevicePropVariantCollection**  ppCategories
);

Parameters

ppCategories

[out]  Address of a variable that receives a pointer to an IPortableDevicePropVariantCollection interface that holds all the functional categories for this device. The values will be GUIDs (type VT_CLSID) in the retrieved PROPVARIANT values. The caller must release this interface when it is done with it.

Return Values

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.

Remarks

Functional categories describe the types of functions that a device can perform, such as image capture, audio capture, and storage. This method is typically very fast, because the driver usually queries the device only on startup and caches the results.

Requirements

Header: Defined in PortableDeviceApi.h

Library: PortableDeviceGUIDs.lib

See Also

Previous Next