次の方法で共有


IAudioOutputSelector::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 メソッドを呼び出します。

要件

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

関連項目

IAudioOutputSelector インターフェイス

IPart::GetLocalId