IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)

Retorna a posição atual, o catálogo de mídia ou os dados de acompanhamento do ISRC. A leitura da posição atual está obsoleta, começando com o Windows Vista.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O buffer em Irp-AssociatedIrp.SystemBuffer> contém uma estrutura CDROM_SUB_Q_DATA_FORMAT com o membro Format definido como um dos seguintes:

IOCTL_CDROM_CURRENT_POSITION

IOCTL_CDROM_MEDIA_CATALOG

IOCTL_CDROM_TRACK_ISRC

Se Format estiver definido como IOCTL_CDROM_TRACK_ISRC, Track deverá ser definido como a faixa para a qual os dados ISRC são solicitados.

Comprimento do buffer de entrada

O comprimento de um Parameters.DeviceIoControl.OutputBufferLength no local da pilha de E/S indica o tamanho, em bytes, do buffer, que deve ser >= sizeof(SUB_Q_CHANNEL_DATA).

.

Buffer de saída

O driver retorna as informações de SUB_Q_CHANNEL_DATA no buffer em Irp-AssociatedIrp.SystemBuffer>.

Comprimento do buffer de saída

Comprimento de um SUB_Q_CHANNEL_DATA.

Bloco de status

O campo Informações é definido como o número de bytes retornados. O campo Status é definido como STATUS_SUCCESS ou possivelmente como STATUS_BUFFER_TOO_SMALL, STATUS_IO_DEVICE_ERROR, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_DEVICE_REQUEST, STATUS_NO_MEDIA_IN_DEVICE, STATUS_DEVICE_NOT_READY, STATUS_IO_TIME_OUT ou STATUS_VERIFY_REQUIRED.

Comentários

A partir do Windows Vista, os drivers de classe CDROM não usam esse IOCTL com o membro de formato definido como IOCTL_CDROM_CURRENT_POSITION. 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

SUB_Q_CHANNEL_DATA