次の方法で共有

IConnector::GetDeviceIdConnectedTo メソッド (devicetopology.h)

  • [アーティクル]

GetDeviceIdConnectedTo メソッドは、このコネクタが接続されているオーディオ デバイスのデバイス識別子 (存在する場合) を取得します。

構文

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

パラメーター

[out] ppwstrDeviceId

接続されているデバイスのデバイス識別子を含む null で終わるワイド文字の文字列のアドレスをメソッドが書き込む文字列ポインターへのポインター。 このメソッドは、文字列のストレージを割り当てます。 呼び出し元は、不要になったときに、CoTaskMemFree 関数を呼び出すことによって、ストレージを解放する必要があります。 GetDeviceIdConnectedTo 呼び出しが失敗した場合、*ppwstrDeviceId は NULL 。 CoTaskMemFree については、Windows SDK のドキュメントを参照してください。

戻り値

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

リターン コード 形容
E_POINTER
 ppwstrDeviceId ポインターが NULL 。
E_NOTFOUND
 このコネクタが接続されていないか、接続のもう一方の側が別のデバイス トポロジ (たとえば、Software_IO接続) ではありません。
E_MEMORY
 メモリ不足。

備考

このメソッドから取得したデバイス識別子は、IMMDeviceEnumerator::GetDevice メソッドへの入力パラメーターとして使用できます。

このメソッドは、次の一連のメソッド呼び出しと機能的には同等ですが、より効率的です。

  • IConnector::GetConnectedTo メソッドを呼び出して、"to" コネクタの IConnector インターフェイスを取得します。
  • IConnector::QueryInterface メソッド (パラメーター iid を REFIID IID_IPart 設定) を呼び出して、"to" コネクタの IPart インターフェイスを取得します。
  • IPart::GetTopologyObject メソッドを呼び出して、"to" デバイス ("to" コネクタを含むデバイス) の IDeviceTopology インターフェイスを取得します。
  • IDeviceTopology::GetDeviceId メソッドを呼び出して、"to" デバイスのデバイス ID を取得します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー devicetopology.h

関連項目

IConnector インターフェイス の

IMMDeviceEnumerator::GetDevice