Metodo IConnector::GetDeviceIdConnectedTo (devicetopology.h)
Il metodo GetDeviceIdConnectedTo ottiene l'identificatore del dispositivo audio, se presente, a cui è connesso questo connettore.
Sintassi
HRESULT GetDeviceIdConnectedTo(
[out] LPWSTR *ppwstrDeviceId
);
Parametri
[out] ppwstrDeviceId
Puntatore a un puntatore di stringa in cui il metodo scrive l'indirizzo di una stringa di caratteri wide con terminazione Null contenente l'identificatore del dispositivo connesso. Il metodo alloca lo spazio di archiviazione per la stringa. Il chiamante è responsabile della liberazione dello spazio di archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se la chiamata GetDeviceIdConnectedTo ha esito negativo, *ppwstrDeviceId è NULL. Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Pointer ppwstrDeviceId è NULL. |
|
Questo connettore non è connesso o l'altro lato della connessione non è un'altra topologia del dispositivo, ad esempio una connessione Software_IO. |
|
Memoria insufficiente. |
Commenti
L'identificatore del dispositivo ottenuto da questo metodo può essere usato come parametro di input per il metodo IMMDeviceEnumerator::GetDevice .
Questo metodo è funzionalmente equivalente a , ma più efficiente rispetto alla seguente serie di chiamate al metodo:
- Chiamare il metodo IConnector::GetConnectedTo per ottenere l'interfaccia IConnector del connettore "a".
- Chiamare il metodo IConnector::QueryInterface (con il parametro iid impostato su REFIID IID_IPart) per ottenere l'interfaccia IPart del connettore "a".
- Chiamare il metodo IPart::GetTopologyObject per ottenere l'interfaccia IDeviceTopology del dispositivo "a" (il dispositivo che contiene il connettore "a").
- Chiamare il metodo IDeviceTopology::GetDeviceId per ottenere l'ID dispositivo del dispositivo "a".
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | devicetopology.h |