IOCTL_CDROM_READ_Q_CHANNEL IOCTL (ntddcdrm.h)
Retorna a posição atual, o catálogo de mídia ou os dados de controle ISRC. A leitura da posição atual é obsoleta, começando pelo Windows Vista.
Código principal
Buffer de entrada
O buffer em >AssociatedIrp.SystemBuffer contém uma estrutura de 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 do 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 >AssociatedIrp.SystemBuffer .
Comprimento do buffer de saída
Comprimento de um SUB_Q_CHANNEL_DATA.
Bloco de status
O campo informações de é definido como o número de bytes retornados. O campo status está definido como STATUS_SUCCESS ou possivelmente 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.
Observações
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 direto em hardware.
Os aplicativos cliente devem usar o da API da MCI (Interface de Controle de Mídia) em vez de emitir esse IOCTL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Obsoleto, começando com o Windows Vista. |
| cabeçalho | ntddcdrm.h (inclua Ntddcdrm.h) |