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
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
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 |