IOCTL_CDROM_GET_VOLUME IOCTL (ntddcdrm.h)

  • Artigo

Determina o volume atual para cada uma das portas de áudio do dispositivo. Obsoleto, começando com o Windows Vista.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Buffer de entrada.

Comprimento do buffer de entrada

Parameters.DeviceIoControl.OutputBufferLength no local da pilha de E/S indica o tamanho, em bytes, do buffer, que deve ser maior ou igual a sizeof(VOLUME_CONTROL).

Buffer de saída

O driver retorna os dados VOLUME_CONTROL no buffer em Irp-AssociatedIrp.SystemBuffer>.

Comprimento do buffer de saída

Comprimento dos dados de VOLUME_CONTROL .

Bloco de status

O campo Informações é definido como sizeof(VOLUME_CONTROL) quando o campo Status é definido como STATUS_SUCCESS. Caso contrário, o campo Informações será definido como zero e o campo Status possivelmente poderá ser definido como STATUS_BUFFER_TOO_SMALL, STATUS_DEVICE_NOT_READY, STATUS_IO_DEVICE_ERROR, STATUS_VERIFY_REQUIRED ou STATUS_IO_TIMEOUT.

Comentários

A partir do Windows Vista, os drivers de classe CDROM não usam esse IOCTL. Antes do Windows Vista, esse IOCTL era usado para reprodução de áudio em unidades de CD-ROM mais antigas que suportavam saída de áudio direta em hardware.

Os aplicativos cliente devem usar a API MCI (Interface de Controle de Mídia) em vez de emitir esse IOCTL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Obsoleto, começando com o Windows Vista.
Cabeçalho ntddcdrm.h (inclua Ntddcdrm.h)

Confira também

VOLUME_CONTROL