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 de sideband.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

SIDEBANDAUDIO_VOLUME_PARAMS estrutura com o índice de ponto de extremidade e o número do 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 de SIDEBANDAUDIO_VOLUME_PARAMS.

Buffer de saída

SIDEBANDAUDIO_VOLUME_PARAMS.

Comprimento do buffer de saída

Tamanho de 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.

Comentários

Esse IOCTL só pode ser chamado do modo kernel.

O IOCTL de atualização de volume pode ser usado em dois modos : atualização e imediato. Se SIDEBANDAUDIO_VOLUME_PARAMS::Immediate o parâmetro for definido como TRUE, o IOCTL retornará imediatamente com o valor de volume atual para o canal solicitado. Se o parâmetro Immediate estiver definido como FALSE, o IRP será pendente pelo driver de áudio de banda lateral (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

Confira também

SIDEBANDAUDIO_VOLUME_PARAMS

Introdução aos códigos de controle de E/S

sidebandaudio.h