IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL (bthhfpddi.h)
O IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR2 IOCTL obtém informações descritivas sobre o dispositivo hfp (perfil livre de mãos) emparelhado.
Esse IOCTL está disponível no Windows 8.1 e em sistemas operacionais posteriores e substitui IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR.
Código principal
Buffer de entrada
Nenhum
Comprimento do buffer de entrada
Nenhum
Buffer de saída
Um buffer que contém uma estrutura de BTHHFP_DESCRIPTOR2 seguida por 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 de BTHHFP_DESCRIPTOR2.
Comprimento do buffer de saída
O tamanho de uma estrutura BTHHFP_DESCRIPTOR2 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. Observe que isso pode ser maior do que o tamanho da estrutura de BTHHFP_DESCRIPTOR2, pois o buffer de saída pode conter outros dados referenciados pela estrutura BTHHFP_DESCRIPTOR2.
Se o Status estiver definido como STATUS_BUFFER_TOO_SMALL, Informações será 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 o parâmetro informações conterá o tamanho do buffer necessário. O driver de áudio aloca o armazenamento necessário e envia a solicitação novamente. Normalmente, um driver de áudio manterá 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.1 |
| servidor com suporte mínimo | Windows Server 2012 R2 |
| cabeçalho | bthhfpddi.h |