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.

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

Vedi anche

Interfaccia IDeviceTopology

IMMDeviceEnumerator::GetDevice