次の方法で共有


IDeviceTopology::GetPartById メソッド (devicetopology.h)

GetPartById メソッドは、ローカル ID で識別される部分を取得します。

構文

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

パラメーター

[in] nId

取得する部分。 このパラメーターは、パーツのローカル ID です。 詳細については、「解説」を参照してください。

[out] ppPart

メソッドが nId で識別されるパーツ オブジェクトの IPart インターフェイスのアドレスを書き込むポインター変数へのポインター。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったときにインターフェイスを 解放 する役割を担います。 GetPartById 呼び出しが失敗した場合、*ppPartNULL です

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
E_INVALIDARG
パラメーター nId は有効なローカル ID ではありません。
E_POINTER
ポインター ppPartNULL です

注釈

ローカル ID は、デバイス トポロジ内のすべてのパーツ間でパーツを一意に識別する数値です。 IAudioInputSelector::GetSelection メソッドと IAudioOutputSelector::GetSelection メソッドは、接続されているパーツのローカル ID を取得します。 IAudioInputSelector::SetSelection メソッドと IAudioOutputSelector::SetSelection メソッドは、ローカル ID で識別されるパーツに接続されている入力または出力を選択します。 パーツ オブジェクトへのポインターがある場合は、 IPart::GetLocalId メソッドを呼び出して、パーツのローカル ID を取得できます。

要件

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

こちらもご覧ください

IAudioInputSelector::GetSelection

IAudioInputSelector::SetSelection

IAudioOutputSelector::GetSelection

IAudioOutputSelector::SetSelection

IDeviceTopology インターフェイス

IPart インターフェイス

IPart::GetLocalId