IPortableDeviceCapabilities::GetFunctionalCategories method (portabledeviceapi.h)
The GetFunctionalCategories method retrieves all functional categories supported by the device.
Syntax
HRESULT GetFunctionalCategories(
[out] IPortableDevicePropVariantCollection **ppCategories
);
Parameters
[out] ppCategories
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 of type VT_CLSID in the retrieved PROPVARIANT values. 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 |
|---|---|
|
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.
Examples
For an example of how to use this method see Retrieving the Functional Categories Supported by a Device.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | portabledeviceapi.h |
| Library | PortableDeviceGUIDs.lib |