IConnector::GetDeviceIdConnectedTo-Methode (devicetopology.h)
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 |