IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

Il driver audio rilascia il codice di controllo IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR per ottenere informazioni su un'interfaccia del dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS abilitata.

Nota Questo IOCTL sostituisce IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES e IOCTL_BTHHFP_DEVICE_GET_CONTAINERID che sono stati deprecati.

 

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Buffer contenente una struttura BTHHFP_DESCRIPTOR 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_DESCRIPTOR.

Lunghezza del buffer di output

Dimensioni di una struttura di BTHHFP_DESCRIPTOR 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.

Nota Questo può essere maggiore delle dimensioni della struttura BTHHFP_DESCRIPTOR, perché il buffer di output può contenere altri dati a cui fa riferimento la struttura

 

Se Status è impostato su STATUS_BUFFER_TOO_SMALL, il driver audio deve leggere il membro Information per ottenere le dimensioni 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 imposta 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
intestazione	bthhfpddi.h

Vedere anche

IOCTLs HFP DDI Bluetooth

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES