IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)

El IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL Obtiene información descriptiva sobre el dispositivo emparejado de perfil manos libres (HFP).

Este IOCTL está disponible en Windows 8.1 y sistemas operativos posteriores, y reemplaza IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

None

Longitud del búfer de entrada

None

Búfer de salida

Búfer que contiene una estructura de BTHHFP_DESCRIPTOR2 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_DESCRIPTOR2 .

Longitud del búfer de salida

Tamaño de una estructura de BTHHFP_DESCRIPTOR2 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. Tenga en cuenta que esto puede ser mayor que el tamaño de la estructura de BTHHFP_DESCRIPTOR2 , ya que el búfer de salida puede contener otros datos a los que hace referencia la estructura BTHHFP_DESCRIPTOR2 .

Si Status se establece en STATUS_BUFFER_TOO_SMALL, Information es 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 el parámetro Information contendrá el tamaño de búfer necesario. A continuación, el controlador de audio asigna el almacenamiento necesario y envía la solicitud de nuevo. Normalmente, un controlador de audio mantendrá 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.1
Servidor mínimo compatible	Windows Server 2012 R2
Encabezado	bthhfpddi.h

Consulte también

BTHHFP_DESCRIPTOR2

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR