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. Questo 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 di BTHHFP_DESCRIPTOR2 e dati a cui si fa riferimento.
Blocco di 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, Information è la dimensione del buffer che il chiamante deve allocare per questa richiesta.
Osservazioni
Il driver audio invia questa richiesta per ottenere informazioni su un'interfaccia del dispositivo abilitata GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS. Le informazioni non cambiano mentre l'interfaccia è abilitata, ma possono cambiare mentre l'interfaccia è disabilitata. Pertanto, 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 necessarie del buffer di output. 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8.1 |
| server minimo supportato | Windows Server 2012 R2 |
| intestazione | bthhfpddi.h |