PGET_DEVICE_INFORMATION funzione di callback (hdaudio.h)
La routine GetDeviceInformation recupera informazioni sul dispositivo controller audio HD.
Il tipo di puntatore di funzione per una routine GetDeviceInformation è definito come segue.
Sintassi
PGET_DEVICE_INFORMATION PgetDeviceInformation;
NTSTATUS PgetDeviceInformation(
[in] PVOID _context,
[in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}
Parametri
[in] _context
Specifica il valore di contesto del Context membro del HDAUDIO_BUS_INTERFACE o della struttura HDAUDIO_BUS_INTERFACE_V2.
[in, out] DeviceInformation
Recupera informazioni sul dispositivo controller audio HD. Questo parametro punta a una struttura di HDAUDIO_DEVICE_INFORMATION allocata dal chiamante in cui la routine scrive le informazioni sul dispositivo.
Valore restituito
GetDeviceInformation restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, la routine restituisce un codice di errore appropriato. Nella tabella seguente viene illustrato un possibile codice di stato restituito.
| Codice restituito | Descrizione |
|---|---|
|
Indica che le dimensioni specificate all'inizio della deviceInformation buffer sono troppo piccole. |
Osservazioni
Questa routine recupera le informazioni dipendenti dal dispositivo che sono statiche, ovvero le informazioni non cambiano in modo dinamico nel tempo.
Il parametro deviceInformation è un puntatore a un buffer contenente una struttura HDAUDIO_DEVICE_INFORMATION in cui la routine scrive informazioni sul controller audio HD. Prima di chiamare GetDeviceInformation, il chiamante alloca il buffer e scrive le dimensioni del buffer in byte nel membro Size all'inizio del buffer.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | hdaudio.h (include Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |