IPortableDeviceCapabilities：：GetFunctionalCategories 方法 (portabledeviceapi.h)

GetFunctionalCategories 方法會擷取裝置支援的所有功能類別。

語法

HRESULT GetFunctionalCategories(
  [out] IPortableDevicePropVariantCollection **ppCategories
);

[out] ppCategories

接收 IPortableDevicePropVariantCollection 介面指標的變數位址，該介面會保存此裝置的所有功能類別。這些值將會是所擷取 PROPVARIANT值中類型VT_CLSID的 GUID。呼叫端必須在完成此介面時釋放此介面。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。

功能類別描述裝置可執行的函式類型，例如影像擷取、音訊擷取和記憶體。此方法通常非常快速，因為驅動程式通常會在啟動時查詢裝置，並快取結果。

如需如何使用此方法的範例，請參閱擷取裝置所支援的功能類別。