IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

O driver de áudio emite o código de controle IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR para obter informações sobre uma interface de dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS habilitada.

Observação Este IOCTL substitui IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES e IOCTL_BTHHFP_DEVICE_GET_CONTAINERID que foram preteridos.

 

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

Um buffer que contém uma estrutura de BTHHFP_DESCRIPTOR seguida por quaisquer outros dados referenciados pela estrutura. Isso é verdadeiro, se o tamanho do buffer de saída for suficiente e a solicitação for bem-sucedida. Em particular, o buffer inclui armazenamento para a cadeia de caracteres referenciada pelo campo FriendlyName da estrutura BTHHFP_DESCRIPTOR.

Comprimento do buffer de saída

O tamanho de uma estrutura BTHHFP_DESCRIPTOR e dados referenciados.

Bloco de status

Se a rotina for bem-sucedida, o Status será definido como STATUS_SUCCESS e o membro de Informações do será o número de bytes que a rotina grava no buffer de saída.

Observação Isso pode ser maior do que o tamanho da estrutura de BTHHFP_DESCRIPTOR, pois o buffer de saída pode conter outros dados referenciados pela estrutura

 

Se Status estiver definido como STATUS_BUFFER_TOO_SMALL, o driver de áudio deverá ler o membro Informações para obter o tamanho do buffer que o chamador deve alocar para essa solicitação.

Observações

O driver de áudio envia essa solicitação para obter informações sobre uma interface de dispositivo GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS habilitada. As informações não são alteradas enquanto a interface está habilitada, mas podem ser alteradas enquanto a interface está desabilitada. Portanto, o driver de áudio envia essa solicitação logo após descobrir uma interface de dispositivo habilitada e usa as informações para criar uma estrutura de KSFILTER_DESCRIPTOR apropriada.

O driver de áudio envia essa solicitação uma vez com um tamanho de buffer de saída igual a zero (0) para determinar o tamanho do buffer de saída necessário. Nesse caso, a solicitação será concluída com o Status STATUS_BUFFER_TOO_SMALL e definirá o membro informações para o tamanho do buffer necessário. O driver de áudio aloca o espaço de armazenamento necessário e envia a solicitação novamente. Normalmente, um driver de áudio armazenará um ponteiro para esse local de armazenamento em seu contexto de dispositivo para referência durante a atividade posterior.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
cabeçalho	bthhfpddi.h

Consulte também

IOCTLs de DDI do HFP Bluetooth

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES