Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetDeviceIdConnectedTo-Methode ruft den Gerätebezeichner des Audiogeräts ab, sofern vorhanden, mit dem dieser Connector verbunden ist.
Syntax
HRESULT GetDeviceIdConnectedTo(
[out] LPWSTR *ppwstrDeviceId
);
Parameter
[out] ppwstrDeviceId
Zeiger auf einen Zeichenfolgenzeiger, in den die -Methode die Adresse einer mit NULL beendeten breitzeichenigen Zeichenfolge schreibt, die den Gerätebezeichner des verbundenen Geräts enthält. Die -Methode weist den Speicher für die Zeichenfolge zu. Der Aufrufer ist für das Freigeben des Speichers verantwortlich, wenn er nicht mehr benötigt wird, indem er die CoTaskMemFree-Funktion aufruft . Wenn der Aufruf GetDeviceIdConnectedTo fehlschlägt , ist *ppwstrDeviceIdNULL. Informationen zu CoTaskMemFree finden Sie in der Dokumentation zum Windows SDK.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ppwstrDeviceId ist NULL. |
|
Dieser Connector ist nicht verbunden, oder die andere Seite der Verbindung ist keine andere Gerätetopologie (z. B. eine Software_IO Verbindung). |
|
Nicht genügend Arbeitsspeicher. |
Hinweise
Der von dieser Methode abgerufene Gerätebezeichner kann als Eingabeparameter für die IMMDeviceEnumerator::GetDevice-Methode verwendet werden.
Diese Methode ist funktionell gleichwertig, aber effizienter als die folgende Reihe von Methodenaufrufen:
- Rufen Sie die IConnector::GetConnectedTo-Methode auf, um die IConnector-Schnittstelle des "to"-Connectors abzurufen.
- Rufen Sie die IConnector::QueryInterface-Methode auf (wobei parameter iid auf REFIID IID_IPart festgelegt ist), um die IPart-Schnittstelle des "to"-Connectors abzurufen.
- Rufen Sie die IPart::GetTopologyObject-Methode auf, um die IDeviceTopology-Schnittstelle des "to"-Geräts abzurufen (das Gerät, das den "to"-Connector enthält).
- Rufen Sie die IDeviceTopology::GetDeviceId-Methode auf, um die Geräte-ID des "to"-Geräts abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |