Metodo IDeviceTopology::GetDeviceId (devicetopology.h)
Il metodo GetDeviceId ottiene l'identificatore del dispositivo rappresentato dall'oggetto device-topology.
Sintassi
HRESULT GetDeviceId(
[out] LPWSTR *ppwstrDeviceId
);
Parametri
[out] ppwstrDeviceId
Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo di una stringa di caratteri null con terminazione null che contiene l'identificatore del dispositivo. Il metodo alloca l'archiviazione per la stringa. Il chiamante è responsabile della liberazione dell'archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se la chiamata GetDeviceId 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 codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Puntatore ppwstrDeviceId è NULL. |
|
Memoria insufficiente. |
Commenti
L'identificatore del dispositivo ottenuto da questo metodo può essere usato come parametro di input per il metodo IMMDeviceEnumerator::GetDevice .
Per un esempio di codice che usa il metodo GetDeviceId , vedere Uso dell'interfaccia IKsControl per accedere alle proprietà audio.
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 |