IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)

  • Articolo

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

IRP_MJ_DEVICE_CONTROL

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

Vedi anche

BTHHFP_DESCRIPTOR2

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR