estrutura CDROM_READ_TOC_EX (ntddcdrm.h)

Artigo
02/07/2025

Quando os drivers consultam um CD-ROM dispositivo de destino com IOCTL_CDROM_READ_TOC_EX eles devem definir a consulta com essa estrutura.

Sintaxe

typedef struct _CDROM_READ_TOC_EX {
  UCHAR Format : 4;
  UCHAR Reserved1 : 3;
  UCHAR Msf : 1;
  UCHAR SessionTrack;
  UCHAR Reserved2;
  UCHAR Reserved3;
} CDROM_READ_TOC_EX, *PCDROM_READ_TOC_EX;

Membros

Format

Especifica a operação de leitura do sumário, da seguinte maneira:

Operação	Descrição
CDROM_READ_TOC_EX_FORMAT_TOC	Consulte o dispositivo para obter o sumário das sessões especificadas. O SessionTrack membro da estrutura especifica o número de faixa inicial da sessão para a qual os dados serão retornados. Para CD-ROMs de várias sessões, esse comando retornará o sumário de dados de conteúdo para todas as sessões. Para o número de faixa 0xAA, ele retorna a área de saída da última sessão completa. Os dados de saída são relatados em uma estrutura de CDROM_TOC.
CDROM_READ_TOC_EX_FORMAT_SESSION	Consulte o dispositivo para o primeiro número de sessão completo, o último número de sessão completo e o último endereço inicial da sessão completa. Os dados de saída são relatados em uma estrutura de CDROM_TOC_SESSION_DATA. Com esse formato, o membro do SessionTrack é reservado e deve ser definido como zero. Esse formato fornece ao iniciador acesso rápido ao último endereço inicial da sessão finalizada.
CDROM_READ_TOC_EX_FORMAT_FULL_TOC	Consulte o dispositivo para todos os dados de subcodificação Q no sumário de áreas de conteúdo que começam a partir do número de sessão especificado no membro SessionTrack. Os dados de saída são relatados em uma estrutura de cabeçalho, CDROM_TOC_FULL_TOC_DATA, seguida por uma série de descritores de faixa definidos em CDROM_TOC_FULL_TOC_DATA_BLOCK. Nesse formato, o LBA (endereçamento de bloco lógico) não é definido e o membro do Msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_PMA	Consulte o dispositivo para todos os dados de subcodificação Q no PMA (área de memória do programa ). Os dados de saída são relatados em uma estrutura de CDROM_TOC_PMA_DATA. Nesse formato, o membro SessionTrack é reservado e deve ser definido como zero. O LBA (endereçamento de bloco lógico) não está definido e o membro do Msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_ATIP	Consulte o dispositivo por tempo absoluto em dados de pregroove (ATIP). Os dados de saída são relatados na estrutura de CDROM_TOC_ATIP_DATA. Nesse formato, o membro SessionTrack é reservado e deve ser definido como zero. O LBA (endereçamento de bloco lógico) não está definido e o membro do Msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_CDTEXT	Consulte o dispositivo para obter informações CD-TEXT que são registradas na área de entrada como dados subcanais R-W. Os dados de saída são relatados em uma estrutura de CDROM_TOC_CD_TEXT_DATA com uma matriz acrescentada de estruturas de CDROM_TOC_CD_TEXT_DATA_BLOCK.

Reserved1

Reservado.

Msf

Indica o bit de segundo de minuto. Quando definido como um, esse bit indica que o endereçamento msf (quadro de segundo de minuto) deve ser usado. Quando zero, indica que o LBA (endereçamento de bloco lógico) deve ser usado.

SessionTrack

Especifica o número da faixa inicial para a qual os dados serão retornados, a sessão para a qual o comando é direcionado ou um campo reservado que os drivers devem definir como zero. Qual desses valores SessionTrack usa depende do valor do membro Format.

Reserved2

Reservado.

Reserved3

Reservado.

Observações

Para obter mais informações e definições de termos usados nesta página de referência e nas páginas de referência de estruturas relacionadas, consulte a especificação T10/1363-D, pelo Comitê Nacional de Padrões de Tecnologia da Informação (NCITS).