Partilhar via


IOCTL_BTHHFP_STREAM_GET_STATUS_UPDATE IOCTL (bthhfpddi.h)

O IOCTL_BTHHFP_STREAM_GET_STATUS_UPDATE IOCTL obtém uma atualização de status do canal de fluxo.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um BOOL definido como TRUE para solicitar uma atualização imediata. Caso contrário, defina isso como FALSE.

Comprimento do buffer de entrada

O tamanho de um BOOL.

Buffer de saída

Um valor NT_STATUS que representa o novo status do canal de fluxo. Um status de erro indica que o canal SCO (orientado à conexão síncrona) associado ao fluxo foi fechado e não pode ser restabelecido.

Comprimento do buffer de saída

O tamanho de um objeto NT_STATUS.

Bloco de status

Se uma solicitação já estiver pendente, a nova solicitação falhará e uma mensagem STATUS_INVALID_DEVICE_REQUEST será retornada.

Se uma solicitação estiver pendente quando uma solicitação IOCTL_BTHHFP_CLOSE_STREAM_CHANNEL ocorrer, a solicitação pendente será cancelada e o bloco de status de E/S mostrará STATUS_CANCELLED.

Observações

Essa solicitação será concluída imediatamente se o parâmetro de entrada for TRUE ou se o status do canal de fluxo tiver sido alterado desde a última solicitação. Caso contrário, essa solicitação permanecerá pendente até que o status do canal de fluxo seja alterado ou a solicitação seja cancelada.

Essa solicitação é válida somente entre uma solicitação de IOCTL_BTHHFP_STREAM_OPEN bem-sucedida e uma solicitação de IOCTL_BTHHFP_STREAM_CLOSE subsequente. Se essa solicitação estiver pendente quando o fluxo for fechado por uma solicitação IOCTL_BTHHFP_STREAM_CLOSE, a solicitação pendente será cancelada.

Um status de erro pode ocorrer quando o link bluetooth é descartado ou outras condições semelhantes ocorrem. Embora essas condições sejam raras, o driver de áudio deve ser desenvolvido para lidar com elas. Esse status de erro geralmente pode ocorrer quase simultaneamente com uma alteração de status de conexão para FALSE. No entanto, o driver de áudio não deve depender dessa alteração de status como uma maneira de determinar se o link Bluetooth foi descartado ou não.

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