IPart::GetLocalId メソッド (devicetopology.h)

GetLocalId メソッドは、この部分のローカル ID を取得します。

構文

HRESULT GetLocalId(
  [out] UINT *pnId
);

[out] pnId

メソッドがこの部分のローカル ID を書き込む UINT 変数へのポインター。

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

リターンコード	説明
E_POINTER	ポインター pnId は NULL です。

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

IAudioInputSelector::GetSelection メソッドと IAudioOutputSelector::GetSelection メソッドは、接続されているパーツのローカル ID を取得します。 IAudioInputSelector::SetSelection メソッドと IAudioOutputSelector::SetSelection メソッドは、ローカル ID で識別されるパーツに接続されている入力または出力を選択します。 IDeviceTopology::GetPartById メソッドは、ローカル ID で識別される部分を取得します。

GetLocalId メソッドを使用するコード例については、次のトピックを参照してください。