IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR IOCTL (sidebandaudio.h)
Il driver audio rilascia il IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR per ottenere informazioni su un'interfaccia del dispositivo audio a banda laterale abilitata. In particolare, restituisce il numero di endpoint audio disponibili in un dispositivo che supporta Sideband. Queste informazioni vengono restituite in una struttura del descrittore del dispositivo audio .
Codice principale
Buffer di input
NULL
Lunghezza del buffer di input
Buffer di output
Buffer contenente una struttura SIDEBANDAUDIO_DEVICE_DESCRIPTOR .
Lunghezza del buffer di output
Dimensione di una struttura SIDEBANDAUDIO_DEVICE_DESCRIPTOR .
Blocco dello stato
Se la routine ha esito positivo, Status viene impostato su STATUS_SUCCESS e il membro Information è il numero di byte che la routine scrive nel buffer di output.
Se Status è impostato su STATUS_BUFFER_TOO_SMALL, il driver audio deve leggere il membro Informazioni per ottenere le dimensioni del buffer che il chiamante deve allocare per questa richiesta.
Commenti
Questo IOCTL può essere chiamato solo dalla modalità kernel.
Il driver audio invia questa richiesta per ottenere informazioni su un'interfaccia del dispositivo audio sideband abilitata. Le informazioni non cambiano mentre l'interfaccia è abilitata, ma possono cambiare mentre l'interfaccia è disabilitata. Il driver audio invia questa richiesta poco dopo aver individuato un'interfaccia del dispositivo audio sideband abilitato e usa le informazioni per determinare il numero di endpoint audio sideband disponibili.
Il driver audio invia questa richiesta una volta con una dimensione del buffer di output pari a zero (0) per determinare le dimensioni del buffer di output necessarie. In questo caso, la richiesta verrà completata con Status STATUS_BUFFER_TOO_SMALL e imposterà il membro Information sulla dimensione del buffer richiesta. Il driver audio alloca quindi lo spazio di archiviazione necessario e invia nuovamente la richiesta. In genere, un driver audio archivierà un puntatore a questa posizione di archiviazione nel contesto del dispositivo per riferimento durante l'attività successiva.
Il driver audio può quindi determinare in modo iterativo ogni funzionalità degli endpoint con il IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR IOCTL.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | sidebandaudio.h |