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

[アーティクル]
02/28/2024

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

構文

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

パラメーター

[in] nId

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

[out] ppPart

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

戻り値

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

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

注釈

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

要件

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