ntddcdrm.h 标头

存储使用此标头。 有关详细信息，请参阅：

• 存储

ntddcdrm.h 包含以下编程接口：

IOCTL

IOCTL_CDROM_CHECK_VERIFY IOCTL_CDROM_CHECK_VERIFY IOCTL 将替换为 Microsoft Windows 2000 及更高版本中的IOCTL_STORAGE_CHECK_VERIFY操作系统。
IOCTL_CDROM_ENABLE_STREAMING 针对原始读取和写入请求，按句柄启用或禁用 CDROM 流模式。
IOCTL_CDROM_EXCLUSIVE_ACCESS IOCTL_CDROM_EXCLUSIVE_ACCESS请求指示 CD-ROM 类驱动程序：报告 CD-ROM 设备的访问状态。
IOCTL_CDROM_FIND_NEW_DEVICES IOCTL_CDROM_FIND_NEW_DEVICES IOCTL 将替换为 Microsoft Windows 2000 及更高版本中的IOCTL_STORAGE_FIND_NEW_DEVICES操作系统。
IOCTL_CDROM_GET_CONFIGURATION 从 CD-ROM 设备请求功能和配置文件信息。
IOCTL_CDROM_GET_CONTROL 此 IOCTL 请求已过时。 请勿使用。确定当前音频播放模式。
IOCTL_CDROM_GET_DRIVE_GEOMETRY 返回有关 CD-ROM 的几何 (介质类型、柱面数、每个柱面的轨迹、每个轨道的扇区以及每个扇区) 的字节数的信息。
IOCTL_CDROM_GET_DRIVE_GEOMETRY_EX 返回有关 CD-ROM 的几何图形 (媒体类型、柱面数、每个柱面的轨迹、每个轨道的扇区以及每个扇区) 的字节数的信息。IOCTL_CDROM_GET_DRIVE_GEOMETRY_EX请求与较旧的IOCTL_CDROM_GET_DRIVE_GEOMETRY请求不同。
IOCTL_CDROM_GET_INQUIRY_DATA 返回 CD-ROM 设备的 SCSI 查询数据。 当设备已使用IOCTL_CDROM_EXCLUSIVE_ACCESS独占锁定时，可以使用此 IOCTL。
IOCTL_CDROM_GET_LAST_SESSION 查询设备中的第一个完整会话编号、最后一个完整会话编号和最后一个完整会话起始地址。
IOCTL_CDROM_GET_PERFORMANCE 从设备检索支持的速度。 IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求是 MMC 命令 GET PERFORMANCE 上的包装器。
IOCTL_CDROM_GET_VOLUME 确定其每个设备音频端口的当前音量。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_LOAD_MEDIA 将突出的 CDROM 托盘拉回到驱动器中。
IOCTL_CDROM_PAUSE_AUDIO 暂停音频播放。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_PLAY_AUDIO_MSF 播放指定的媒体范围。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_RAW_READ 在原始模式下从 CD-ROM 读取数据。
IOCTL_CDROM_READ_Q_CHANNEL 返回当前位置、媒体目录或 ISRC 跟踪数据。 从 Windows Vista 开始，读取当前位置已过时。
IOCTL_CDROM_READ_TOC 返回媒体的目录。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_READ_TOC_EX 在目标设备中查询目录 (TOC) 、程序内存区域 (PMA) ，以及 pregroove (ATIP) 中的绝对时间。
IOCTL_CDROM_RESUME_AUDIO 恢复暂停的音频操作。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_SEEK_AUDIO_MSF 将头移动到媒体上的指定 MSF。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_SEND_OPC_INFORMATION IOCTL_CDROM_SEND_OPC_INFORMATION控制代码可用于文件系统和其他实现，这些实现需要提前执行最佳电源校准 (OPC) 过程，这样第一次流式写入就不必等待过程完成。 光学驱动器执行 OPC 过程，以确定写入期间激光的最佳功率。 该过程是确保质量所必需的，但它会磨损介质，不应太频繁地执行。
IOCTL_CDROM_SET_SPEED 设置 CD-ROM 驱动器的轴速。
IOCTL_CDROM_SET_VOLUME 重置其设备的音频端口的音量。 已过时，从 Windows Vista 开始。
IOCTL_CDROM_STOP_AUDIO 结束音频播放。 已过时，从 Windows Vista 开始。

结构

CDROM_AUDIO_CONTROL CDROM_AUDIO_CONTROL结构与IOCTL_CDROM_GET_CONTROL请求结合使用，以报告音频播放模式。
CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR CDROM_EXCEPTION_PERFORMANCE_DESCRIPTOR结构指示来自IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求的结果数据适用于异常情况。
CDROM_EXCLUSIVE_ACCESS CDROM_EXCLUSIVE_ACCESS结构与IOCTL_CDROM_EXCLUSIVE_ACCESS请求一起使用，以查询 CD-ROM 设备的访问状态，或锁定或解锁设备以获取独占访问权限。
CDROM_EXCLUSIVE_LOCK CDROM_EXCLUSIVE_LOCK结构与IOCTL_CDROM_EXCLUSIVE_ACCESS请求一起使用，以锁定 CD-ROM 设备进行独占访问。
CDROM_EXCLUSIVE_LOCK_STATE CD-ROM 类驱动程序使用CDROM_EXCLUSIVE_LOCK_STATE结构来报告 CD-ROM 设备的独占访问状态。
CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR结构为主机提供了逻辑单元性能的近似值。
CDROM_PERFORMANCE_HEADER IOCTL_CDROM_GET_PERFORMANCE IOCTL 使用CDROM_PERFORMANCE_HEADER结构返回数据。 当请求类型为 CdromPerformanceRequest 时，IOCTL 将返回此标头，后跟可选描述符。
CDROM_PERFORMANCE_REQUEST CDROM_PERFORMANCE_REQUEST 结构用作IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求的输入参数，并描述请求的性能数据。
CDROM_PLAY_AUDIO_MSF 控制代码为 IOCTL_CDROM_PLAY_AUDIO_MSF 的设备控制 IRP 使用此结构播放音频 CD。
CDROM_READ_TOC_EX 当驱动程序使用 IOCTL_CDROM_READ_TOC_EX查询目标 CD-ROM 设备时，它们必须使用此结构定义查询。
CDROM_SEEK_AUDIO_MSF CDROM_SEEK_AUDIO_MSF 结构包含设备在收到设备控制 IRP 时必须查找的分钟、秒和帧，其控制代码为 IOCTL_CDROM_SEEK_AUDIO_MSF。
CDROM_SET_SPEED CDROM_SET_SPEED结构与IOCTL_CDROM_SET_SPEED请求一起使用，以设置数据传输期间不允许数据丢失的 CD-ROM 驱动器的主轴速度。
CDROM_SET_STREAMING CDROM_SET_SPEED结构与IOCTL_CDROM_SET_SPEED请求一起使用，以设置 CD-ROM 驱动器在允许某些数据丢失的常时等量传输期间的轴速。
CDROM_SIMPLE_OPC_INFO CDROM_SIMPLE_OPC_INFO 结构是IOCTL_CDROM_SEND_OPC_INFORMATION I/O 控制代码的唯一输入。
CDROM_STREAMING_CONTROL CDROM_STREAMING_CONTROL 结构用作IOCTL_CDROM_ENABLE_STREAMING IOCTL 的输入参数。
CDROM_SUB_Q_DATA_FORMAT CDROM_SUB_Q_DATA_FORMAT结构与 IOCTL_CDROM_READ_Q_CHANNEL 类型的设备控制 IRP 一起使用。
CDROM_TOC 控制代码为 IOCTL_CDROM_READ_TOC_EX 且格式为 CDROM_READ_TOC_EX_FORMAT_TOC的设备控制 IRP 在此结构中返回其输出数据，后跟一系列TRACK_DATA结构。
CDROM_TOC_ATIP_DATA 控制代码为 IOCTL_CDROM_READ_TOC_EX 且格式为 CDROM_READ_TOC_EX_FORMAT_ATIP的设备控制 IRP 在此标头结构中返回其输出数据，后跟一系列类型为 CDROM_TOC_ATIP_DATA_BLOCK 的描述符。
CDROM_TOC_ATIP_DATA_BLOCK 控制代码为 IOCTL_CDROM_READ_TOC_EX 且格式为 CDROM_READ_TOC_EX_FORMAT_ATIP的设备控制 IRP 在 CDROM_TOC_ATIP_DATA 类型的标头结构中返回其输出数据，后跟由 CDROM_TOC_ATIP_DATA_BLOCK 定义的一系列 ATIP 数据块描述符。
CDROM_TOC_CD_TEXT_DATA 控制代码为 IOCTL_CDROM_READ_TOC_EX 的设备控制 IRP 和格式CDROM_READ_TOC_EX_FORMAT_CDTEXT在此结构中返回其输出数据，后跟一系列CDROM_TOC_CD_TEXT_DATA_BLOCK类型的描述符。
CDROM_TOC_CD_TEXT_DATA_BLOCK 此结构包含与 CDROM_TOC_CD_TEXT_DATA 结构中的数据结合使用的 CD 文本描述符数据。
CDROM_TOC_FULL_TOC_DATA 具有IOCTL_CDROM_READ_TOC_EX控制代码和格式CDROM_READ_TOC_EX_FORMAT_FULL_TOC在此结构中返回其输出数据的设备控制 IRP（可选）后跟一系列CDROM_TOC_FULL_TOC_DATA_BLOCK类型的描述符。
CDROM_TOC_FULL_TOC_DATA_BLOCK CDROM_TOC_FULL_TOC_DATA_BLOCK 结构包含与CDROM_TOC_FULL_TOC_DATA结构中的数据结合使用的跟踪描述符数据。
CDROM_TOC_PMA_DATA 具有IOCTL_CDROM_READ_TOC_EX控制代码和格式CDROM_READ_TOC_EX_FORMAT_PMA在此结构中返回其输出数据的设备控制 IRP（可选）后跟一系列CDROM_TOC_FULL_TOC_DATA_BLOCK类型的描述符。
CDROM_TOC_SESSION_DATA 控制代码为 IOCTL_CDROM_READ_TOC_EX 且格式为 CDROM_READ_TOC_EX_FORMAT_SESSION的设备控制 IRP 在此结构中返回其输出数据，后跟一系列TRACK_DATA结构。
CDROM_WRITE_SPEED_DESCRIPTOR 当请求类型为 CdromWriteSpeedRequest 时，为IOCTL_CDROM_GET_PERFORMANCE IOCTL 返回CDROM_WRITE_SPEED_DESCRIPTOR结构。
CDROM_WRITE_SPEED_REQUEST CDROM_WRITE_SPEED_REQUEST 结构用作IOCTL_CDROM_GET_PERFORMANCE IOCTL 和请求写入速度描述符的输入参数。
RAW_READ_INFO RAW_READ_INFO 结构与IOCTL_CDROM_RAW_READ请求结合使用，以在原始模式下从 CD-ROM 读取数据。
SUB_Q_CHANNEL_DATA 控制代码为 的设备控制 IRP IOCTL_CDROM_READ_Q_CHANNEL在此联合中返回其输出数据。
SUB_Q_CURRENT_POSITION SUB_Q_CURRENT_POSITION 结构包含位置信息，并与 SUB_Q_CHANNEL_DATA 结合使用。
SUB_Q_HEADER SUB_Q_HEADER结构包含音频状态信息和要返回的 Q 子通道数据的长度。 此结构与 SUB_Q_CHANNEL_DATA 结合使用。
SUB_Q_MEDIA_CATALOG_NUMBER SUB_Q_MEDIA_CATALOG_NUMBER 结构包含位置信息，并与 SUB_Q_CHANNEL_DATA 结构结合使用。
SUB_Q_TRACK_ISRC SUB_Q_TRACK_ISC包含位置信息，并与 SUB_Q_CHANNEL_DATA 结构结合使用。
TRACK_DATA 跟踪描述符与CDROM_TOC和CDROM_TOC_SESSION_DATA结合使用。
VOLUME_CONTROL VOLUME_CONTROL 结构与 IOCTL_CDROM_GET_VOLUME 请求结合使用，以检索最多四个音频端口的音量值。

枚举

CDROM_OPC_INFO_TYPE CDROM_OPC_INFO_TYPE 枚举是 CDROM_SIMPLE_OPC_INFO 结构的成员。 它定义最佳功率校准 (OPC) 请求，用作IOCTL_CDROM_SEND_OPC_INFORMATION I/O 控制请求的输入。
CDROM_PERFORMANCE_EXCEPTION_TYPE CDROM_PERFORMANCE_EXCEPTION_TYPE 枚举定义性能数据的异常条件。
CDROM_PERFORMANCE_REQUEST_TYPE CDROM_PERFORMANCE_REQUEST_TYPE枚举定义性能数据请求的类型。 它是 CDROM_PERFORMANCE_REQUEST 结构的成员，用作IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求的输入参数。
CDROM_PERFORMANCE_TOLERANCE_TYPE CDROM_PERFORMANCE_TOLERANCE_TYPE 枚举定义性能数据允许的容差。 它是 CDROM_PERFORMANCE_REQUEST 结构的成员，用作IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求的输入参数。
CDROM_PERFORMANCE_TYPE CDROM_PERFORMANCE_TYPE枚举定义读取和写入性能数据请求。 它是 CDROM_PERFORMANCE_REQUEST 结构的成员，用作IOCTL_CDROM_GET_PERFORMANCE I/O 控制请求的输入参数。
CDROM_SPEED_REQUEST CDROM_SPEED_REQUEST枚举指示 CD-ROM 类驱动程序将使用哪个命令来设置 CD-ROM 驱动器的轴速。
EXCLUSIVE_ACCESS_REQUEST_TYPE EXCLUSIVE_ACCESS_REQUEST_TYPE 枚举用于报告 CD-ROM 设备的独占访问状态。
STREAMING_CONTROL_REQUEST_TYPE STREAMING_CONTROL_REQUEST_TYPE 枚举定义 CDROM 流式处理模式。
TRACK_MODE_TYPE TRACK_MODE_TYPE 枚举类型与IOCTL_CDROM_RAW_READ请求和RAW_READ_INFO结构结合使用，以在原始模式下从 CD-ROM 读取数据。
WRITE_ROTATION WRITE_ROTATION 枚举指定 CD-ROM 驱动器在写入 CD 时，是使用固定线性速度 (CLV) 旋转还是使用固定角速度 (CAV) 旋转。