IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL (sidebandaudio.h)

Artigo
02/26/2024

O driver de áudio pode chamar a IOCTL_SBAUD_GET_MUTEPROPERTYVALUES IOCTL para consultar os intervalos de dados escalonados mudos e valores mínimos/máximos para todos os canais. Esses valores devem ser retornados para KSPROPERTY_AUDIO_MUTE suporte básico.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Um valor de índice de ponto de extremidade baseado em 0 com base no número de pontos de extremidade de áudio, conforme relatado pela IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR. Esse é um valor ULONG de 0 para (N-1) em que N é o número de pontos de extremidade para o dispositivo.

Comprimento do buffer de entrada

Tamanho do ULONG.

Buffer de saída

KSPROPERTY_DESCRIPTION seguido por intervalos de dados escalonados KSPROPERTY_MEMBERSHEADER e Mudo, conforme documentado em KSPROPERTY_DESCRIPTION e KSPROPERTY_MEMBERSHEADER.

Se NULL, Irp-IoStatus.Information> será definido como o número de bytes necessários para o buffer de saída.

Comprimento do buffer de saída

Tamanho de KSPROPERTY_DESCRIPTION além de todos os intervalos de KSPROPERTY_MEMBERSHEADER e etapas. Esse tamanho é retornado em SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR. MutePropertyValuesSize.

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.

Se o buffer de saída for NULL, Irp-IoStatus.Status> será definido como STATUS_BUFFER_TOO_SMALL e Irp-IoStatus.Information> será definido como o número de bytes necessários para o buffer de saída.

Se o buffer de saída de tamanho adequado for fornecido, Irp-IoStatus.Information> será definido como o número de bytes gravados no buffer de saída.

Para obter mais informações, consulte Valores NTSTATUS.

Comentários

Esse IOCTL só pode ser chamado do modo kernel.

Os drivers de áudio que implementam áudio de sideband devem anunciar o mudo do ponto de extremidade por meio de um nó mudo em seu Filtro KS ou por meio do Nó do Mecanismo de Áudio. Ambos os métodos podem utilizar as informações básicas de suporte fornecidas por este IOCTL.