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 abilitata GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS.

Nota Questo IOCTL sostituisce IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES e IOCTL_BTHHFP_DEVICE_GET_CONTAINERID che ora 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 qualsiasi altro dato a cui fa riferimento la struttura. Questa operazione è vera, se la dimensione del buffer di output è sufficiente 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 BTHHFP_DESCRIPTOR e dati a cui si fa riferimento.

Blocco dello stato

Se la routine ha esito positivo, Status è impostato su STATUS_SUCCESS e il membro Information è il numero di byte che la routine scrive nel buffer di output.

Nota Può essere maggiore della dimensione della struttura BTHHFP_DESCRIPTOR , poiché il buffer di output può contenere altri dati a cui fa riferimento la struttura

 

Se stato è 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

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 aver individuato un'interfaccia del dispositivo abilitata e usa le informazioni per compilare 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 Stato STATUS_BUFFER_TOO_SMALL e impostare il membro Informazioni sulla dimensione del buffer necessaria. 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 relativo contesto del dispositivo per riferimento durante l'attività successiva.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Intestazione	bthhfpddi.h

Vedi anche

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES