Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Returns the table of contents of the media. Obsolete, beginning with Windows Vista.
Major code
Input buffer
Input buffer.
Input buffer length
Parameters.DeviceIoControl.OutputBufferLength in the I/O stack location indicates the size, in bytes, of the buffer, which must be greater than or equal to sizeof(CDROM_TOC).Output buffer
The driver returns the CDROM_TOC data in the buffer at Irp->AssociatedIrp.SystemBuffer.
Output buffer length
Length of a CDROM_TOC.
Status block
The Information field is set to the number of bytes returned. The Status field is set to STATUS_SUCCESS, or possibly to STATUS_BUFFER_TOO_SMALL, STATUS_NO_MEDIA_IN_DEVICE, STATUS_DEVICE_NOT_READY, STATUS_IO_TIMEOUT, STATUS_IO_DEVICE_ERROR, STATUS_DEVICE_BUSY, or STATUS_VERIFY_REQUIRED.
Remarks
Beginning with Windows Vista, CDROM class drivers do not use this IOCTL. Prior to Windows Vista, this IOCTL was used for audio playback on older CD-ROM drives that supported direct audio output in hardware.
Client applications should use the Media Control Interface (MCI) API rather than issuing this IOCTL.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Obsolete, beginning with Windows Vista. |
| Header | ntddcdrm.h (include Ntddcdrm.h) |