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

GetFunctionalObjects メソッドは、デバイス上の指定したカテゴリに一致するすべての機能オブジェクトを取得します。

構文

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

パラメーター

[in] Category

検索するカテゴリを指定する REFGUID 。 これは、すべての機能オブジェクトを返すためにWPD_FUNCTIONAL_CATEGORY_ALLできます。

[out] ppObjectIDs

関数オブジェクトのオブジェクト ID を文字列として格納する IPortableDevicePropVariantCollection インターフェイスへのポインターを受け取る変数のアドレス (取得した PROPVARIANT 項目の型VT_LPWSTR)。 要求された型のオブジェクトが見つからない場合、これは空のコレクションになります ( NULL ではありません)。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。

戻り値

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

解説

ドライバーは完全なコンテンツ列挙を実行する必要がないため、通常、この操作は高速であり、取得された機能オブジェクトの数は通常 10 未満です。 要求された型のオブジェクトが見つからない場合、このメソッドはエラーを返しませんが、 ppObjectIDs の空のコレクションを返します。

例

このメソッドの使用方法の例については、「デバイスの機能オブジェクト識別子の取得」を参照してください。

必要条件

関連項目

IPortableDeviceCapabilities インターフェイス

デバイスの機能オブジェクト識別子の取得

デバイスでサポートされているレンダリング機能の取得