IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
Il IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL Ottiene informazioni descrittive sul dispositivo HFP (Handsfree Profile) associato.
Questo IOCTL è disponibile nei sistemi operativi Windows 8.1 e versioni successive e sostituisce IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.
Codice principale
Buffer di input
Nessuno
Lunghezza del buffer di input
Nessuno
Buffer di output
Buffer contenente una struttura BTHHFP_DESCRIPTOR2 seguita da tutti gli altri dati a cui fa riferimento la struttura. Ciò vale se le dimensioni del buffer di output sono sufficienti e la richiesta ha esito positivo. In particolare, il buffer include l'archiviazione per la stringa a cui fa riferimento il campo FriendlyName della struttura BTHHFP_DESCRIPTOR2 .
Lunghezza del buffer di output
Dimensioni di una struttura BTHHFP_DESCRIPTOR2 e dati a cui si fa riferimento.
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. Si noti che può essere maggiore della dimensione della struttura BTHHFP_DESCRIPTOR2 , perché il buffer di output può contenere altri dati a cui fa riferimento la struttura BTHHFP_DESCRIPTOR2 .
Se Status è impostato su STATUS_BUFFER_TOO_SMALL, le informazioni sono le dimensioni del buffer che il chiamante deve allocare per questa richiesta.
Commenti
Il driver audio invia questa richiesta per ottenere informazioni su un'interfaccia del dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS abilitata. Le informazioni non cambiano mentre l'interfaccia è abilitata, ma possono cambiare mentre l'interfaccia è disabilitata. Di conseguenza, il driver audio invia questa richiesta poco dopo l'individuazione di un'interfaccia del dispositivo abilitata e usa le informazioni per creare una struttura di KSFILTER_DESCRIPTOR appropriata.
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 il parametro Information conterrà le dimensioni del buffer necessarie. Il driver audio alloca quindi la risorsa di archiviazione necessaria e invia nuovamente la richiesta. In genere, un driver audio manterrà un puntatore a questa posizione di archiviazione nel contesto del dispositivo per riferimento durante l'attività successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 |
| Server minimo supportato | Windows Server 2012 R2 |
| Intestazione | bthhfpddi.h |