IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL (sidebandaudio.h)
O IOCTL_SBAUD_GET_VOLUME_STATUS_UPDATE IOCTL obtém a configuração de nível de volume do ponto de extremidade de áudio da faixa lateral.
Código principal
Buffer de entrada
SIDEBANDAUDIO_VOLUME_PARAMS estrutura com o índice de ponto de extremidade e o número de canal baseados em 0, juntamente com o parâmetro "imediato", indicando se esse IOCTL deve ser processado imediatamente ou pendente para atualizações futuras.
Comprimento do buffer de entrada
Tamanho do SIDEBANDAUDIO_VOLUME_PARAMS.
Buffer de saída
Comprimento do buffer de saída
Tamanho do SIDEBANDAUDIO_VOLUME_PARAMS.
Bloco de status
Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, status para a condição de erro apropriada como um código NTSTATUS. Para obter mais informações, consulte valores NTSTATUS.
Observações
Esse IOCTL só pode ser chamado do modo kernel.
A atualização de volume IOCTL pode ser usada em dois modos : atualização e imediata. Se SIDEBANDAUDIO_VOLUME_PARAMS::Immediate parâmetro for definido como TRUE, o IOCTL retornará imediatamente com o valor de volume atual do canal solicitado. Se o parâmetro Immediate estiver definido como FALSE, o IRP será pendente pelo driver de áudio de sideband (como áudio USB) até que haja uma alteração no volume do dispositivo. O driver de áudio deve configurar um IOCTL de volume pendente para ser notificado sobre quaisquer alterações no volume de hardware.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | sidebandaudio.h |
Consulte também
introdução aos códigos de controle de E/S