IAudioInputSelector::SetSelection メソッド (devicetopology.h)

  • [アーティクル]

SetSelection メソッドは、入力セレクターの入力のいずれかを選択します。

構文

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] nIdSelect

新しいセレクター入力。 呼び出し元は、セレクター入力の 1 つに直接リンクがあるパーツのローカル ID にこのパラメーターを設定する必要があります。

[in] pguidEventContext

IControlChangeNotify::OnNotify メソッドのコンテキスト値。 このパラメーターは、イベント コンテキスト GUID を指します。 SetSelection 呼び出しによって入力セレクター コントロールの状態が変更された場合、そのコントロールに IControlChangeNotify インターフェイスを登録しているすべてのクライアントが通知を受け取ります。 OnNotify メソッドの実装では、クライアントはイベント コンテキスト GUID を検査して、それがコントロール変更イベントのソースであるかどうかを検出できます。 呼び出し元がこのパラメーターに NULL ポインターを指定した場合、クライアントの通知メソッドは NULL コンテキスト ポインターを受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_INVALIDARG
 パラメーター nIdSelect は、セレクター入力のパーツのローカル ID ではありません。
E_OUTOFMEMORY
 メモリが不足しています。

注釈

ローカル ID は、デバイス トポロジ内のすべてのパーツ間でパーツを一意に識別する数値です。 パーツのローカル ID を取得するには、パーツ オブジェクトの IPart::GetLocalId メソッドを呼び出します。

SetSelection メソッドを呼び出すコード例については、「デバイス トポロジ」の SelectCaptureDevice 関数の実装を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー devicetopology.h

こちらもご覧ください

IAudioInputSelector インターフェイス

IPart::GetLocalId