estrutura CDROM_PERFORMANCE_HEADER (ntddcdrm.h)

Artigo
02/29/2024

A estrutura CDROM_PERFORMANCE_HEADER é usada pelo IOCTL_CDROM_GET_PERFORMANCE IOCTL para retornar dados. Quando o tipo de solicitação é CdromPerformanceRequest, o IOCTL retorna esse cabeçalho seguido por descritores opcionais.

Sintaxe

typedef struct _CDROM_PERFORMANCE_HEADER {
  UCHAR DataLength[4];
  UCHAR Except : 1;
  UCHAR Write : 1;
  UCHAR Reserved1 : 6;
  UCHAR Reserved2[3];
  UCHAR Data[0];
} CDROM_PERFORMANCE_HEADER, *PCDROM_PERFORMANCE_HEADER;

Membros

DataLength[4]

O tamanho dos dados disponíveis (não apenas o tamanho dos dados retornados). O tamanho não inclui esse campo Datalength .

Except

O formato dos descritores que seguem o cabeçalho depende do valor neste campo. Se for false (0), o CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR seguirá o CDROM_PERFORMANCE_HEADER nos dados retornados. Se true (1), o CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR segue o CDROM_PERFORMANCE_HEADER nos dados retornados.

Write

Indica se os dados de resultado são para desempenho de leitura ou gravação. Se false (0), indica que os dados de resultado são para desempenho de leitura. Se true (1), indica que os dados de resultado são para desempenho de gravação.

Reserved1

Reservado.

Reserved2[3]

Reservado.

Data[0]

Contém uma lista dos seguintes registros, dependendo do tipo de solicitação: CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR,
CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR,
CDROM_WRITE_SPEED_DESCRIPTOR.