PGET_DEVICE_INFORMATION funzione di callback (hdaudio.h)
La GetDeviceInformation routine recupera informazioni sul dispositivo controller audio HD.
Il tipo di puntatore a funzione per una GetDeviceInformation routine è 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 dal membro Context del HDAUDIO_BUS_INTERFACE o dalla 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 del buffer deviceInformation sono troppo piccole. |
Commenti
Questa routine recupera le informazioni dipendenti dal dispositivo, ovvero statiche, le informazioni non cambiano dinamicamente nel tempo.
Il parametro deviceInformation è un puntatore a un buffer che contiene 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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | hdaudio.h (include Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |