IMFVirtualCamera::AddProperty メソッド (mfvirtualcamera.h)

カスタムデバイスインターフェイスプロパティを仮想カメラに追加します。

構文

HRESULT AddProperty(
  const DEVPROPKEY *pKey,
  DEVPROPTYPE      Type,
  const BYTE       *pbData,
  ULONG            cbData
);

pKey

仮想カメラデバイスインターフェイスに追加する DEVPROPKEY へのポインター。詳細については、「統合デバイスプロパティモデル」を参照してください。

Type

指定した pKey のプロパティの種類。 DEVPROP_TYPE_NULL型とDEVPROP_TYPE_EMPTY型はサポートされていません。

pbData

プロパティデータへのポインター。

cbData

データが指すバッファーに含まれるサイズ (バイト単位)。

次の値を含むがこれらに限定されない HRESULT 値を返します。

エラーコード	説明
S_OK	成功
E_INVALIDARG	入力パラメーターが無効です。
E_ACCESSDENIED	呼び出し元には、プロパティを追加するための十分なアクセス許可がありません。

呼び出し元には、この API を使用するための管理者レベルのアクセス許可が必要です。 UWP アプリとパッケージアプリには、このメソッドを呼び出すアクセス許可がありません。

呼び出し元は、予期しない影響を及ぼす可能性があるため、既知の Windows デバイスプロパティを追加する場合は注意が必要です。