IOCTL_CDROM_READ_TOC IOCTL (ntddcdrm.h)

  • Artigo

Retorna o sumário da mídia. 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(CDROM_TOC).

Buffer de saída

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

Comprimento do buffer de saída

Comprimento de um CDROM_TOC.

Bloco de status

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

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 cd-ROM mais antigas que suportavam saída de áudio direta no hardware.

Os aplicativos cliente devem usar a API da 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

CDROM_TOC