IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

El controlador de audio emite el código de control IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR para obtener información sobre una interfaz de dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS habilitada.

Nota Este IOCTL sustituye a IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES y IOCTL_BTHHFP_DEVICE_GET_CONTAINERID que ahora han quedado en desuso.

 

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Ninguno.

Longitud del búfer de entrada

Ninguno.

Búfer de salida

Un búfer que contiene una estructura de BTHHFP_DESCRIPTOR seguida de cualquier otro dato al que hace referencia la estructura. Esto es cierto, si el tamaño del búfer de salida es suficiente y la solicitud se realiza correctamente. En concreto, el búfer incluye almacenamiento para la cadena a la que hace referencia el campo FriendlyName de la estructura BTHHFP_DESCRIPTOR .

Longitud del búfer de salida

Tamaño de una estructura de BTHHFP_DESCRIPTOR y datos a los que se hace referencia.

Bloque de estado

Si la rutina se realiza correctamente, Status se establece en STATUS_SUCCESS y el miembro Information es el número de bytes que escribe la rutina en el búfer de salida.

Nota Puede ser mayor que el tamaño de la estructura de BTHHFP_DESCRIPTOR , ya que el búfer de salida puede contener otros datos a los que hace referencia la estructura.

 

Si Status está establecido en STATUS_BUFFER_TOO_SMALL, el controlador de audio debe leer el miembro Information para obtener el tamaño del búfer que el autor de la llamada debe asignar para esta solicitud.

Comentarios

El controlador de audio envía esta solicitud para obtener información sobre una interfaz de dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS habilitada. La información no cambia mientras la interfaz está habilitada, pero puede cambiar mientras la interfaz está deshabilitada. Por lo tanto, el controlador de audio envía esta solicitud poco después de detectar una interfaz de dispositivo habilitada y usa la información para crear una estructura de KSFILTER_DESCRIPTOR adecuada.

El controlador de audio envía esta solicitud una vez con un tamaño de búfer de salida de cero (0) para determinar el tamaño de búfer de salida necesario. En este caso, la solicitud se completará con status STATUS_BUFFER_TOO_SMALL y establecerá el miembro Information en el tamaño de búfer necesario. A continuación, el controlador de audio asigna el espacio de almacenamiento necesario y envía la solicitud de nuevo. Normalmente, un controlador de audio almacenará un puntero a esta ubicación de almacenamiento en su contexto de dispositivo como referencia durante la actividad posterior.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Encabezado	bthhfpddi.h

Consulte también

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES