estrutura CDROM_READ_TOC_EX (ntddcdrm.h)

Artigo
08/07/2023

Quando os drivers consultam um dispositivo CD-ROM 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 membro SessionTrack da estrutura especifica o número da 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 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 CDROM_TOC .
CDROM_READ_TOC_EX_FORMAT_SESSION	Consulte o dispositivo para obter 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 CDROM_TOC_SESSION_DATA . Com esse formato, o membro 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 subcódigo 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, seguidos 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 msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_PMA	Consulte o dispositivo para obter todos os dados de subcódigo Q na PMA ( área de memória do programa ). Os dados de saída são relatados em uma estrutura 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 msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_ATIP	Consulte o dispositivo por tempo absoluto em dados de pré-movimentação (ATIP). Os dados de saída são relatados na estrutura 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 msf deve ser definido como 1.
CDROM_READ_TOC_EX_FORMAT_CDTEXT	Consulte o dispositivo para obter informações de CD-TEXT registradas na área de entrada como dados de subcanal R-W. Os dados de saída são relatados em uma estrutura 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 quadro de minuto. Quando definido como um, esse bit indica que o endereçamento MSF (quadro de segundo 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 o 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.

Comentários

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 especificação T10/1363-D, pelo Comitê Nacional de Padrões de Tecnologia da Informação (NCITS).