IPortableDeviceCapabilities::GetFunctionalCategories メソッド (portabledeviceapi.h)

GetFunctionalCategories メソッドは、デバイスでサポートされているすべての機能カテゴリを取得します。

構文

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

パラメーター

[out] ppCategories

このデバイスのすべての機能カテゴリを保持する IPortableDevicePropVariantCollection インターフェイスへのポインターを受け取る変数のアドレス。 値は、取得した PROPVARIANT 値にVT_CLSID型の GUIDになります。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。

注釈

機能カテゴリは、イメージ キャプチャ、オーディオ キャプチャ、ストレージなど、デバイスで実行できる機能の種類を表します。 ドライバーは通常、起動時にのみデバイスに対してクエリを実行し、結果をキャッシュするため、通常、このメソッドは非常に高速です。

例

このメソッドの使用方法の例については、「 デバイスでサポートされている機能カテゴリの取得」を参照してください。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

こちらもご覧ください

IPortableDeviceCapabilities インターフェイス

デバイスでサポートされている機能カテゴリの取得