CDROM_READ_TOC_EX 構造体 (ntddcdrm.h)

[アーティクル]
08/07/2023

ドライバーは、 IOCTL_CDROM_READ_TOC_EX を使用してターゲット CD-ROM デバイスに対してクエリを実行する場合、この構造でクエリを定義する必要があります。

構文

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;

メンバー

Format

目次の読み取り操作を次のように指定します。

操作	説明
CDROM_READ_TOC_EX_FORMAT_TOC	指定したセッションの目次をデバイスに照会します。構造体の SessionTrack メンバーは、データが返されるセッションの開始トラック番号を指定します。マルチセッション CD-ROM の場合、このコマンドは、すべてのセッションの目次データを返します。トラック番号0xAAの場合は、最後に完了したセッションのリードアウト領域が返されます。出力データは、 CDROM_TOC 構造で報告されます。
CDROM_READ_TOC_EX_FORMAT_SESSION	最初の完全なセッション番号、最後の完了セッション番号、最後に完了したセッション開始アドレスをデバイスに照会します。出力データは、CDROM_TOC_SESSION_DATA 構造で報告されます。この形式では、 SessionTrack メンバーは予約済みであり、0 に設定する必要があります。この形式により、イニシエーターは最後に終了したセッション開始アドレスにすばやくアクセスできます。
CDROM_READ_TOC_EX_FORMAT_FULL_TOC	SessionTrack メンバーで指定されたセッション番号から始まる、潜在顧客目次領域のすべての Q サブコードデータをデバイスに照会します。出力データは、ヘッダー構造 (CDROM_TOC_FULL_TOC_DATA)、その後に CDROM_TOC_FULL_TOC_DATA_BLOCK で定義された一連のトラック記述子で報告されます。この形式では、論理ブロックアドレス指定 (LBA) が定義されておらず、 Msf メンバーを 1 に設定する必要があります。
CDROM_READ_TOC_EX_FORMAT_PMA	プログラム・メモリー域 (PMA) 内のすべての Q サブコード・データを照会します。出力データは、 CDROM_TOC_PMA_DATA 構造で報告されます。この形式では、 SessionTrack メンバーは予約されており、0 に設定する必要があります。論理ブロックアドレス指定 (LBA) が定義されていないため、 Msf メンバーを 1 に設定する必要があります。
CDROM_READ_TOC_EX_FORMAT_ATIP	pregroove (ATIP) データの絶対時間をデバイスに照会します。出力データは、 CDROM_TOC_ATIP_DATA 構造体で報告されます。この形式では、 SessionTrack メンバーは予約されており、0 に設定する必要があります。論理ブロックアドレス指定 (LBA) が定義されていないため、 Msf メンバーを 1 に設定する必要があります。
CDROM_READ_TOC_EX_FORMAT_CDTEXT	リードイン領域に R-W サブチャネルデータとして記録されている CD-TEXT 情報をデバイスに照会します。出力データは、 CDROM_TOC_CD_TEXT_DATA_BLOCK 構造体の配列が追加された CDROM_TOC_CD_TEXT_DATA構造体で報告されます。