MFCreateSensorGroup 関数 (mfidl.h)

  • [アーティクル]

指定されたシンボリック リンク名に基づいて 、IMFSensorGroup インターフェイスのインスタンスを作成します。

構文

HRESULT MFCreateSensorGroup(
        LPCWSTR        SensorGroupSymbolicLink,
  [out] IMFSensorGroup **ppSensorGroup
);

パラメーター

SensorGroupSymbolicLink

新しい IMFSensorGroup のシンボリック リンク。 この名前は、SetupDiGetClassDevs や MFEnumDeviceSources などのデバイス列挙 API を使用するか、DeviceInformation クラスの Id プロパティを取得することによって取得できます。

[out] ppSensorGroup

新しい IMFSensorGroup のシンボリック リンク。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 指定された IMFSensorGroup が null です。
E_INVALIDARG
 指定された LPCWSTR は null です。

注釈

関数が成功すると、 ppSensorGroup は有効な IMFSensorGroup オブジェクトを指します。 呼び出し元はこのインターフェイスを解放する必要があります。

メモ この API を KSCATEGORY_SENSOR_CAMERAまたはシンボリック 名 KSCATEGORY_VIDEO_CAMERA 使用すると、結果の IMFSensorGroup オブジェクトには 1 つのセンサー デバイスのみが含まれますが、仮想化されたセンサー グループとして動作します。 呼び出し元は、KSCATEGORY_SENSOR_GROUPから取得したセンサー グループと同じ方法で、結果の オブジェクトを使用できます。
 

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1607 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mfidl.h