285 lines
7.7 KiB
C
285 lines
7.7 KiB
C
/*++ BUILD Version: 0001 // Increment this if a change has global effects
|
|
|
|
Copyright (c) 1990-1993 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
ntddcdrm.h
|
|
|
|
Abstract:
|
|
|
|
This module contains structures and definitions
|
|
associated with CDROM IOCTls.
|
|
|
|
Author:
|
|
|
|
Mike Glass
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
//
|
|
// NtDeviceIoControlFile IoControlCode values for this device.
|
|
//
|
|
// Warning: Remember that the low two bits of the code specify how the
|
|
// buffers are passed to the driver!
|
|
//
|
|
|
|
#define IOCTL_CDROM_BASE FILE_DEVICE_CD_ROM
|
|
|
|
#define IOCTL_CDROM_UNLOAD_DRIVER CTL_CODE(IOCTL_CDROM_BASE, 0x0402, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
//
|
|
// CDROM Audio Device Control Functions
|
|
//
|
|
|
|
#define IOCTL_CDROM_READ_TOC CTL_CODE(IOCTL_CDROM_BASE, 0x0000, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_GET_CONTROL CTL_CODE(IOCTL_CDROM_BASE, 0x000D, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_PLAY_AUDIO_MSF CTL_CODE(IOCTL_CDROM_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_SEEK_AUDIO_MSF CTL_CODE(IOCTL_CDROM_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_STOP_AUDIO CTL_CODE(IOCTL_CDROM_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_PAUSE_AUDIO CTL_CODE(IOCTL_CDROM_BASE, 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_RESUME_AUDIO CTL_CODE(IOCTL_CDROM_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_GET_VOLUME CTL_CODE(IOCTL_CDROM_BASE, 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_SET_VOLUME CTL_CODE(IOCTL_CDROM_BASE, 0x000A, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_READ_Q_CHANNEL CTL_CODE(IOCTL_CDROM_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_GET_LAST_SESSION CTL_CODE(IOCTL_CDROM_BASE, 0x000E, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_RAW_READ CTL_CODE(IOCTL_CDROM_BASE, 0x000F, METHOD_OUT_DIRECT, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_DISK_TYPE CTL_CODE(IOCTL_CDROM_BASE, 0x0010, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
|
|
#define IOCTL_CDROM_GET_DRIVE_GEOMETRY CTL_CODE(IOCTL_CDROM_BASE, 0x0013, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
//
|
|
// The following device control codes are common for all class drivers. The
|
|
// functions codes defined here must match all of the other class drivers.
|
|
//
|
|
// Warning: these codes will be replaced in the future with the IOCTL_STORAGE
|
|
// codes included below
|
|
//
|
|
|
|
#define IOCTL_CDROM_CHECK_VERIFY CTL_CODE(IOCTL_CDROM_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_MEDIA_REMOVAL CTL_CODE(IOCTL_CDROM_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_EJECT_MEDIA CTL_CODE(IOCTL_CDROM_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_LOAD_MEDIA CTL_CODE(IOCTL_CDROM_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_RESERVE CTL_CODE(IOCTL_CDROM_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_RELEASE CTL_CODE(IOCTL_CDROM_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
#define IOCTL_CDROM_FIND_NEW_DEVICES CTL_CODE(IOCTL_CDROM_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
//
|
|
// The following file contains the IOCTL_STORAGE class ioctl definitions
|
|
//
|
|
|
|
#include <ntddstor.h>
|
|
|
|
//
|
|
// The following device control code is for the SIMBAD simulated bad
|
|
// sector facility. See SIMBAD.H in this directory for related structures.
|
|
//
|
|
|
|
#define IOCTL_CDROM_SIMBAD CTL_CODE(IOCTL_CDROM_BASE, 0x1003, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
//
|
|
// Maximum CD Rom size
|
|
//
|
|
|
|
#define MAXIMUM_NUMBER_TRACKS 100
|
|
#define MAXIMUM_CDROM_SIZE 804
|
|
|
|
//
|
|
// CD ROM Table OF Contents (TOC)
|
|
//
|
|
// Format 0 - Get table of contents
|
|
//
|
|
|
|
typedef struct _TRACK_DATA {
|
|
UCHAR Reserved;
|
|
UCHAR Control : 4;
|
|
UCHAR Adr : 4;
|
|
UCHAR TrackNumber;
|
|
UCHAR Reserved1;
|
|
UCHAR Address[4];
|
|
} TRACK_DATA, *PTRACK_DATA;
|
|
|
|
typedef struct _CDROM_TOC {
|
|
|
|
//
|
|
// Header
|
|
//
|
|
|
|
UCHAR Length[2];
|
|
UCHAR FirstTrack;
|
|
UCHAR LastTrack;
|
|
|
|
//
|
|
// Track data
|
|
//
|
|
|
|
TRACK_DATA TrackData[MAXIMUM_NUMBER_TRACKS];
|
|
} CDROM_TOC, *PCDROM_TOC;
|
|
|
|
#define CDROM_TOC_SIZE sizeof(CDROM_TOC)
|
|
|
|
//
|
|
// Play audio starting at MSF and ending at MSF
|
|
//
|
|
|
|
typedef struct _CDROM_PLAY_AUDIO_MSF {
|
|
UCHAR StartingM;
|
|
UCHAR StartingS;
|
|
UCHAR StartingF;
|
|
UCHAR EndingM;
|
|
UCHAR EndingS;
|
|
UCHAR EndingF;
|
|
} CDROM_PLAY_AUDIO_MSF, *PCDROM_PLAY_AUDIO_MSF;
|
|
|
|
//
|
|
// Seek to MSF
|
|
//
|
|
|
|
typedef struct _CDROM_SEEK_AUDIO_MSF {
|
|
UCHAR M;
|
|
UCHAR S;
|
|
UCHAR F;
|
|
} CDROM_SEEK_AUDIO_MSF, *PCDROM_SEEK_AUDIO_MSF;
|
|
|
|
|
|
//
|
|
// Flags for the disk type
|
|
//
|
|
|
|
typedef struct _CDROM_DISK_DATA {
|
|
|
|
ULONG DiskData;
|
|
|
|
} CDROM_DISK_DATA, *PCDROM_DISK_DATA;
|
|
|
|
#define CDROM_DISK_AUDIO_TRACK (0x00000001)
|
|
#define CDROM_DISK_DATA_TRACK (0x00000002)
|
|
|
|
//
|
|
// CD ROM Data Mode Codes, used with IOCTL_CDROM_READ_Q_CHANNEL
|
|
//
|
|
|
|
#define IOCTL_CDROM_SUB_Q_CHANNEL 0x00
|
|
#define IOCTL_CDROM_CURRENT_POSITION 0x01
|
|
#define IOCTL_CDROM_MEDIA_CATALOG 0x02
|
|
#define IOCTL_CDROM_TRACK_ISRC 0x03
|
|
|
|
typedef struct _CDROM_SUB_Q_DATA_FORMAT {
|
|
UCHAR Format;
|
|
UCHAR Track;
|
|
} CDROM_SUB_Q_DATA_FORMAT, *PCDROM_SUB_Q_DATA_FORMAT;
|
|
|
|
|
|
//
|
|
// CD ROM Sub-Q Channel Data Format
|
|
//
|
|
|
|
typedef struct _SUB_Q_HEADER {
|
|
UCHAR Reserved;
|
|
UCHAR AudioStatus;
|
|
UCHAR DataLength[2];
|
|
} SUB_Q_HEADER, *PSUB_Q_HEADER;
|
|
|
|
typedef struct _SUB_Q_CURRENT_POSITION {
|
|
SUB_Q_HEADER Header;
|
|
UCHAR FormatCode;
|
|
UCHAR Control : 4;
|
|
UCHAR ADR : 4;
|
|
UCHAR TrackNumber;
|
|
UCHAR IndexNumber;
|
|
UCHAR AbsoluteAddress[4];
|
|
UCHAR TrackRelativeAddress[4];
|
|
} SUB_Q_CURRENT_POSITION, *PSUB_Q_CURRENT_POSITION;
|
|
|
|
typedef struct _SUB_Q_MEDIA_CATALOG_NUMBER {
|
|
SUB_Q_HEADER Header;
|
|
UCHAR FormatCode;
|
|
UCHAR Reserved[3];
|
|
UCHAR Reserved1 : 7;
|
|
UCHAR Mcval : 1;
|
|
UCHAR MediaCatalog[15];
|
|
} SUB_Q_MEDIA_CATALOG_NUMBER, *PSUB_Q_MEDIA_CATALOG_NUMBER;
|
|
|
|
typedef struct _SUB_Q_TRACK_ISRC {
|
|
SUB_Q_HEADER Header;
|
|
UCHAR FormatCode;
|
|
UCHAR Reserved0;
|
|
UCHAR Track;
|
|
UCHAR Reserved1;
|
|
UCHAR Reserved2 : 7;
|
|
UCHAR Tcval : 1;
|
|
UCHAR TrackIsrc[15];
|
|
} SUB_Q_TRACK_ISRC, *PSUB_Q_TRACK_ISRC;
|
|
|
|
typedef union _SUB_Q_CHANNEL_DATA {
|
|
SUB_Q_CURRENT_POSITION CurrentPosition;
|
|
SUB_Q_MEDIA_CATALOG_NUMBER MediaCatalog;
|
|
SUB_Q_TRACK_ISRC TrackIsrc;
|
|
} SUB_Q_CHANNEL_DATA, *PSUB_Q_CHANNEL_DATA;
|
|
|
|
//
|
|
// Audio Status Codes
|
|
//
|
|
|
|
#define AUDIO_STATUS_NOT_SUPPORTED 0x00
|
|
#define AUDIO_STATUS_IN_PROGRESS 0x11
|
|
#define AUDIO_STATUS_PAUSED 0x12
|
|
#define AUDIO_STATUS_PLAY_COMPLETE 0x13
|
|
#define AUDIO_STATUS_PLAY_ERROR 0x14
|
|
#define AUDIO_STATUS_NO_STATUS 0x15
|
|
|
|
//
|
|
// ADR Sub-channel Q Field
|
|
//
|
|
|
|
#define ADR_NO_MODE_INFORMATION 0x0
|
|
#define ADR_ENCODES_CURRENT_POSITION 0x1
|
|
#define ADR_ENCODES_MEDIA_CATALOG 0x2
|
|
#define ADR_ENCODES_ISRC 0x3
|
|
|
|
//
|
|
// Sub-channel Q Control Bits
|
|
//
|
|
|
|
#define AUDIO_WITH_PREEMPHASIS 0x0
|
|
#define DIGITAL_COPY_PERMITTED 0x2
|
|
#define AUDIO_DATA_TRACK 0x4
|
|
#define TWO_FOUR_CHANNEL_AUDIO 0x8
|
|
|
|
//
|
|
// Get Audio control parameters
|
|
//
|
|
|
|
typedef struct _CDROM_AUDIO_CONTROL {
|
|
UCHAR LbaFormat;
|
|
USHORT LogicalBlocksPerSecond;
|
|
} CDROM_AUDIO_CONTROL, *PCDROM_AUDIO_CONTROL;
|
|
|
|
//
|
|
// Volume control - Volume takes a value between 1 and 0xFF.
|
|
// SCSI-II CDROM audio suppports up to 4 audio ports with
|
|
// Independent volume control.
|
|
//
|
|
|
|
typedef struct _VOLUME_CONTROL {
|
|
UCHAR PortVolume[4];
|
|
} VOLUME_CONTROL, *PVOLUME_CONTROL;
|
|
|
|
typedef enum _TRACK_MODE_TYPE {
|
|
YellowMode2,
|
|
XAForm2,
|
|
CDDA
|
|
} TRACK_MODE_TYPE, *PTRACK_MODE_TYPE;
|
|
|
|
//
|
|
// Passed to cdrom to describe the raw read, ie. Mode 2, Form 2, CDDA...
|
|
//
|
|
|
|
typedef struct __RAW_READ_INFO {
|
|
LARGE_INTEGER DiskOffset;
|
|
ULONG SectorCount;
|
|
TRACK_MODE_TYPE TrackMode;
|
|
} RAW_READ_INFO, *PRAW_READ_INFO;
|