ntddcdrm.h
上传用户:xjjlds
上传日期:2015-12-05
资源大小:22823k
文件大小:14k
源码类别:

多媒体编程

开发平台:

Visual C++

  1. /*++ BUILD Version: 0001    // Increment this if a change has global effects
  2. Copyright (c) Microsoft Corporation. All rights reserved.
  3. Module Name:
  4.     ntddcdrm.h
  5. Abstract:
  6.     This module contains structures and definitions
  7.     associated with CDROM IOCTls.
  8. Author:
  9.     Mike Glass
  10. Revision History:
  11. --*/
  12. // begin_winioctl
  13. #ifndef _NTDDCDRM_
  14. #define _NTDDCDRM_
  15. #if _MSC_VER >= 1200
  16. #pragma warning(push)
  17. #endif
  18. #if _MSC_VER > 1000
  19. #pragma once
  20. #endif
  21. //
  22. // remove some level 4 warnings for this header file:
  23. #pragma warning(disable:4200) // array[0]
  24. #pragma warning(disable:4201) // nameless struct/unions
  25. #pragma warning(disable:4214) // bit fields other than int
  26. #ifdef __cplusplus
  27. extern "C" {
  28. #endif
  29. //
  30. // NtDeviceIoControlFile IoControlCode values for this device.
  31. //
  32. // Warning:  Remember that the low two bits of the code specify how the
  33. //           buffers are passed to the driver!
  34. //
  35. #define IOCTL_CDROM_BASE                 FILE_DEVICE_CD_ROM
  36. #define IOCTL_CDROM_UNLOAD_DRIVER        CTL_CODE(IOCTL_CDROM_BASE, 0x0402, METHOD_BUFFERED, FILE_READ_ACCESS)
  37. //
  38. // CDROM Audio Device Control Functions
  39. //
  40. #define IOCTL_CDROM_READ_TOC         CTL_CODE(IOCTL_CDROM_BASE, 0x0000, METHOD_BUFFERED, FILE_READ_ACCESS)
  41. #define IOCTL_CDROM_SEEK_AUDIO_MSF   CTL_CODE(IOCTL_CDROM_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS)
  42. #define IOCTL_CDROM_STOP_AUDIO       CTL_CODE(IOCTL_CDROM_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS)
  43. #define IOCTL_CDROM_PAUSE_AUDIO      CTL_CODE(IOCTL_CDROM_BASE, 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS)
  44. #define IOCTL_CDROM_RESUME_AUDIO     CTL_CODE(IOCTL_CDROM_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS)
  45. #define IOCTL_CDROM_GET_VOLUME       CTL_CODE(IOCTL_CDROM_BASE, 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS)
  46. #define IOCTL_CDROM_PLAY_AUDIO_MSF   CTL_CODE(IOCTL_CDROM_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS)
  47. #define IOCTL_CDROM_SET_VOLUME       CTL_CODE(IOCTL_CDROM_BASE, 0x000A, METHOD_BUFFERED, FILE_READ_ACCESS)
  48. #define IOCTL_CDROM_READ_Q_CHANNEL   CTL_CODE(IOCTL_CDROM_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS)
  49. #define IOCTL_CDROM_GET_CONTROL      CTL_CODE(IOCTL_CDROM_BASE, 0x000D, METHOD_BUFFERED, FILE_READ_ACCESS)
  50. #define IOCTL_CDROM_GET_LAST_SESSION CTL_CODE(IOCTL_CDROM_BASE, 0x000E, METHOD_BUFFERED, FILE_READ_ACCESS)
  51. #define IOCTL_CDROM_RAW_READ         CTL_CODE(IOCTL_CDROM_BASE, 0x000F, METHOD_OUT_DIRECT,  FILE_READ_ACCESS)
  52. #define IOCTL_CDROM_DISK_TYPE        CTL_CODE(IOCTL_CDROM_BASE, 0x0010, METHOD_BUFFERED, FILE_ANY_ACCESS)
  53. #define IOCTL_CDROM_GET_DRIVE_GEOMETRY    CTL_CODE(IOCTL_CDROM_BASE, 0x0013, METHOD_BUFFERED, FILE_READ_ACCESS)
  54. #define IOCTL_CDROM_GET_DRIVE_GEOMETRY_EX CTL_CODE(IOCTL_CDROM_BASE, 0x0014, METHOD_BUFFERED, FILE_READ_ACCESS)
  55. #define IOCTL_CDROM_READ_TOC_EX       CTL_CODE(IOCTL_CDROM_BASE, 0x0015, METHOD_BUFFERED, FILE_READ_ACCESS)
  56. #define IOCTL_CDROM_GET_CONFIGURATION CTL_CODE(IOCTL_CDROM_BASE, 0x0016, METHOD_BUFFERED, FILE_READ_ACCESS)
  57. // end_winioctl
  58. //
  59. // The following device control codes are common for all class drivers.  The
  60. // functions codes defined here must match all of the other class drivers.
  61. //
  62. // Warning: these codes will be replaced in the future with the IOCTL_STORAGE
  63. // codes included below
  64. //
  65. #define IOCTL_CDROM_CHECK_VERIFY    CTL_CODE(IOCTL_CDROM_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS)
  66. #define IOCTL_CDROM_MEDIA_REMOVAL   CTL_CODE(IOCTL_CDROM_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS)
  67. #define IOCTL_CDROM_EJECT_MEDIA     CTL_CODE(IOCTL_CDROM_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS)
  68. #define IOCTL_CDROM_LOAD_MEDIA      CTL_CODE(IOCTL_CDROM_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS)
  69. #define IOCTL_CDROM_RESERVE         CTL_CODE(IOCTL_CDROM_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS)
  70. #define IOCTL_CDROM_RELEASE         CTL_CODE(IOCTL_CDROM_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS)
  71. #define IOCTL_CDROM_FIND_NEW_DEVICES CTL_CODE(IOCTL_CDROM_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS)
  72. //
  73. // The following file contains the IOCTL_STORAGE class ioctl definitions
  74. //
  75. #include "ntddstor.h"
  76. // begin_winioctl
  77. //
  78. // The following device control code is for the SIMBAD simulated bad
  79. // sector facility. See SIMBAD.H in this directory for related structures.
  80. //
  81. #define IOCTL_CDROM_SIMBAD        CTL_CODE(IOCTL_CDROM_BASE, 0x1003, METHOD_BUFFERED, FILE_READ_ACCESS)
  82. //
  83. // Maximum CD Rom size
  84. //
  85. #define MAXIMUM_NUMBER_TRACKS 100
  86. #define MAXIMUM_CDROM_SIZE 804
  87. #define MINIMUM_CDROM_READ_TOC_EX_SIZE 2  // two bytes min transferred
  88. //
  89. // READ_TOC_EX structure
  90. //
  91. typedef struct _CDROM_READ_TOC_EX {
  92.     UCHAR Format    : 4;
  93.     UCHAR Reserved1 : 3; // future expansion
  94.     UCHAR Msf       : 1;
  95.     UCHAR SessionTrack;
  96.     UCHAR Reserved2;     // future expansion
  97.     UCHAR Reserved3;     // future expansion
  98. } CDROM_READ_TOC_EX, *PCDROM_READ_TOC_EX;
  99. #define CDROM_READ_TOC_EX_FORMAT_TOC      0x00
  100. #define CDROM_READ_TOC_EX_FORMAT_SESSION  0x01
  101. #define CDROM_READ_TOC_EX_FORMAT_FULL_TOC 0x02
  102. #define CDROM_READ_TOC_EX_FORMAT_PMA      0x03
  103. #define CDROM_READ_TOC_EX_FORMAT_ATIP     0x04
  104. #define CDROM_READ_TOC_EX_FORMAT_CDTEXT   0x05
  105. //
  106. // CD ROM Table OF Contents (TOC)
  107. // Format 0 - Get table of contents
  108. //
  109. typedef struct _TRACK_DATA {
  110.     UCHAR Reserved;
  111.     UCHAR Control : 4;
  112.     UCHAR Adr : 4;
  113.     UCHAR TrackNumber;
  114.     UCHAR Reserved1;
  115.     UCHAR Address[4];
  116. } TRACK_DATA, *PTRACK_DATA;
  117. typedef struct _CDROM_TOC {
  118.     //
  119.     // Header
  120.     //
  121.     UCHAR Length[2];  // add two bytes for this field
  122.     UCHAR FirstTrack;
  123.     UCHAR LastTrack;
  124.     //
  125.     // Track data
  126.     //
  127.     TRACK_DATA TrackData[MAXIMUM_NUMBER_TRACKS];
  128. } CDROM_TOC, *PCDROM_TOC;
  129. #define CDROM_TOC_SIZE sizeof(CDROM_TOC)
  130. //
  131. // CD ROM Table OF Contents
  132. // Format 1 - Session Information
  133. //
  134. typedef struct _CDROM_TOC_SESSION_DATA {
  135.     
  136.     //
  137.     // Header
  138.     //
  139.     UCHAR Length[2];  // add two bytes for this field
  140.     UCHAR FirstCompleteSession;
  141.     UCHAR LastCompleteSession;
  142.     //
  143.     // One track, representing the first track
  144.     // of the last finished session
  145.     //
  146.     TRACK_DATA TrackData[1];
  147. } CDROM_TOC_SESSION_DATA, *PCDROM_TOC_SESSION_DATA;
  148. //
  149. // CD ROM Table OF Contents
  150. // Format 2 - Full TOC
  151. //
  152. typedef struct _CDROM_TOC_FULL_TOC_DATA_BLOCK {
  153.     UCHAR SessionNumber;
  154.     UCHAR Control      : 4;
  155.     UCHAR Adr          : 4;
  156.     UCHAR Reserved1;
  157.     UCHAR Point;
  158.     UCHAR MsfExtra[3];
  159.     UCHAR Zero;
  160.     UCHAR Msf[3];
  161. } CDROM_TOC_FULL_TOC_DATA_BLOCK, *PCDROM_TOC_FULL_TOC_DATA_BLOCK;
  162. typedef struct _CDROM_TOC_FULL_TOC_DATA {
  163.     
  164.     //
  165.     // Header
  166.     //
  167.     UCHAR Length[2];  // add two bytes for this field
  168.     UCHAR FirstCompleteSession;
  169.     UCHAR LastCompleteSession;
  170.     //
  171.     // one to N descriptors included
  172.     //
  173.     CDROM_TOC_FULL_TOC_DATA_BLOCK Descriptors[0];
  174. } CDROM_TOC_FULL_TOC_DATA, *PCDROM_TOC_FULL_TOC_DATA;
  175. //
  176. // CD ROM Table OF Contents
  177. // Format 3 - Program Memory Area
  178. //
  179. typedef struct _CDROM_TOC_PMA_DATA {
  180.     
  181.     //
  182.     // Header
  183.     //
  184.     UCHAR Length[2];  // add two bytes for this field
  185.     UCHAR Reserved1;
  186.     UCHAR Reserved2;
  187.     //
  188.     // one to N descriptors included
  189.     //
  190.     CDROM_TOC_FULL_TOC_DATA_BLOCK Descriptors[0];
  191. } CDROM_TOC_PMA_DATA, *PCDROM_TOC_PMA_DATA;
  192. //
  193. // CD ROM Table OF Contents
  194. // Format 4 - Absolute Time In Pregroove
  195. //
  196. typedef struct _CDROM_TOC_ATIP_DATA_BLOCK {
  197.     UCHAR CdrwReferenceSpeed : 3;
  198.     UCHAR Reserved3          : 1;
  199.     UCHAR WritePower         : 3;
  200.     UCHAR True1              : 1;
  201.     UCHAR Reserved4       : 6;
  202.     UCHAR UnrestrictedUse : 1;
  203.     UCHAR Reserved5       : 1;
  204.     UCHAR A3Valid     : 1;
  205.     UCHAR A2Valid     : 1;
  206.     UCHAR A1Valid     : 1;
  207.     UCHAR DiscSubType : 3;
  208.     UCHAR IsCdrw      : 1;
  209.     UCHAR True2       : 1;
  210.     UCHAR Reserved7;
  211.     
  212.     UCHAR LeadInMsf[3];
  213.     UCHAR Reserved8;
  214.     
  215.     UCHAR LeadOutMsf[3];
  216.     UCHAR Reserved9;
  217.     
  218.     UCHAR A1Values[3];
  219.     UCHAR Reserved10;
  220.     
  221.     UCHAR A2Values[3];
  222.     UCHAR Reserved11;
  223.     UCHAR A3Values[3];
  224.     UCHAR Reserved12;
  225. } CDROM_TOC_ATIP_DATA_BLOCK, *PCDROM_TOC_ATIP_DATA_BLOCK;
  226. typedef struct _CDROM_TOC_ATIP_DATA {
  227.     
  228.     //
  229.     // Header
  230.     //
  231.     UCHAR Length[2];  // add two bytes for this field
  232.     UCHAR Reserved1;
  233.     UCHAR Reserved2;
  234.     //
  235.     // zero? to N descriptors included.
  236.     //
  237.     CDROM_TOC_ATIP_DATA_BLOCK Descriptors[0];
  238. } CDROM_TOC_ATIP_DATA, *PCDROM_TOC_ATIP_DATA;
  239. //
  240. // CD ROM Table OF Contents
  241. // Format 5 - CD Text Info
  242. //
  243. typedef struct _CDROM_TOC_CD_TEXT_DATA_BLOCK {
  244.     UCHAR PackType;
  245.     UCHAR TrackNumber       : 7;
  246.     UCHAR ExtensionFlag     : 1;  // should be zero!
  247.     UCHAR SequenceNumber;
  248.     UCHAR CharacterPosition : 4;
  249.     UCHAR BlockNumber       : 3;
  250.     UCHAR Unicode           : 1;
  251.     union {
  252.         UCHAR Text[12];
  253.         WCHAR WText[6];
  254.     };
  255.     UCHAR CRC[2];
  256. } CDROM_TOC_CD_TEXT_DATA_BLOCK, *PCDROM_TOC_CD_TEXT_DATA_BLOCK;
  257. typedef struct _CDROM_TOC_CD_TEXT_DATA {
  258.     
  259.     //
  260.     // Header
  261.     //
  262.     UCHAR Length[2];  // add two bytes for this field
  263.     UCHAR Reserved1;
  264.     UCHAR Reserved2;
  265.     
  266.     //
  267.     // the text info comes in discrete blocks of
  268.     // a heavily-overloaded structure
  269.     //
  270.     
  271.     CDROM_TOC_CD_TEXT_DATA_BLOCK Descriptors[0];
  272. } CDROM_TOC_CD_TEXT_DATA, *PCDROM_TOC_CD_TEXT_DATA;
  273. //
  274. // These are the types used for PackType field in CDROM_TOC_CD_TEXT_DATA_BLOCK
  275. // and also for requesting specific info from IOCTL_CDROM_READ_CD_TEXT
  276. //
  277. #define CDROM_CD_TEXT_PACK_ALBUM_NAME 0x80
  278. #define CDROM_CD_TEXT_PACK_PERFORMER  0x81
  279. #define CDROM_CD_TEXT_PACK_SONGWRITER 0x82
  280. #define CDROM_CD_TEXT_PACK_COMPOSER   0x83
  281. #define CDROM_CD_TEXT_PACK_ARRANGER   0x84
  282. #define CDROM_CD_TEXT_PACK_MESSAGES   0x85
  283. #define CDROM_CD_TEXT_PACK_DISC_ID    0x86
  284. #define CDROM_CD_TEXT_PACK_GENRE      0x87
  285. #define CDROM_CD_TEXT_PACK_TOC_INFO   0x88
  286. #define CDROM_CD_TEXT_PACK_TOC_INFO2  0x89
  287. // 0x8a - 0x8d are reserved....
  288. #define CDROM_CD_TEXT_PACK_UPC_EAN    0x8e
  289. #define CDROM_CD_TEXT_PACK_SIZE_INFO  0x8f
  290. //
  291. // Play audio starting at MSF and ending at MSF
  292. //
  293. typedef struct _CDROM_PLAY_AUDIO_MSF {
  294.     UCHAR StartingM;
  295.     UCHAR StartingS;
  296.     UCHAR StartingF;
  297.     UCHAR EndingM;
  298.     UCHAR EndingS;
  299.     UCHAR EndingF;
  300. } CDROM_PLAY_AUDIO_MSF, *PCDROM_PLAY_AUDIO_MSF;
  301. //
  302. // Seek to MSF
  303. //
  304. typedef struct _CDROM_SEEK_AUDIO_MSF {
  305.     UCHAR M;
  306.     UCHAR S;
  307.     UCHAR F;
  308. } CDROM_SEEK_AUDIO_MSF, *PCDROM_SEEK_AUDIO_MSF;
  309. //
  310. //  Flags for the disk type
  311. //
  312. typedef struct _CDROM_DISK_DATA {
  313.     ULONG DiskData;
  314. } CDROM_DISK_DATA, *PCDROM_DISK_DATA;
  315. #define CDROM_DISK_AUDIO_TRACK      (0x00000001)
  316. #define CDROM_DISK_DATA_TRACK       (0x00000002)
  317. //
  318. // CD ROM Data Mode Codes, used with IOCTL_CDROM_READ_Q_CHANNEL
  319. //
  320. #define IOCTL_CDROM_SUB_Q_CHANNEL    0x00
  321. #define IOCTL_CDROM_CURRENT_POSITION 0x01
  322. #define IOCTL_CDROM_MEDIA_CATALOG    0x02
  323. #define IOCTL_CDROM_TRACK_ISRC       0x03
  324. typedef struct _CDROM_SUB_Q_DATA_FORMAT {
  325.     UCHAR Format;
  326.     UCHAR Track;
  327. } CDROM_SUB_Q_DATA_FORMAT, *PCDROM_SUB_Q_DATA_FORMAT;
  328. //
  329. // CD ROM Sub-Q Channel Data Format
  330. //
  331. typedef struct _SUB_Q_HEADER {
  332.     UCHAR Reserved;
  333.     UCHAR AudioStatus;
  334.     UCHAR DataLength[2];
  335. } SUB_Q_HEADER, *PSUB_Q_HEADER;
  336. typedef struct _SUB_Q_CURRENT_POSITION {
  337.     SUB_Q_HEADER Header;
  338.     UCHAR FormatCode;
  339.     UCHAR Control : 4;
  340.     UCHAR ADR : 4;
  341.     UCHAR TrackNumber;
  342.     UCHAR IndexNumber;
  343.     UCHAR AbsoluteAddress[4];
  344.     UCHAR TrackRelativeAddress[4];
  345. } SUB_Q_CURRENT_POSITION, *PSUB_Q_CURRENT_POSITION;
  346. typedef struct _SUB_Q_MEDIA_CATALOG_NUMBER {
  347.     SUB_Q_HEADER Header;
  348.     UCHAR FormatCode;
  349.     UCHAR Reserved[3];
  350.     UCHAR Reserved1 : 7;
  351.     UCHAR Mcval : 1;
  352.     UCHAR MediaCatalog[15];
  353. } SUB_Q_MEDIA_CATALOG_NUMBER, *PSUB_Q_MEDIA_CATALOG_NUMBER;
  354. typedef struct _SUB_Q_TRACK_ISRC {
  355.     SUB_Q_HEADER Header;
  356.     UCHAR FormatCode;
  357.     UCHAR Reserved0;
  358.     UCHAR Track;
  359.     UCHAR Reserved1;
  360.     UCHAR Reserved2 : 7;
  361.     UCHAR Tcval : 1;
  362.     UCHAR TrackIsrc[15];
  363. } SUB_Q_TRACK_ISRC, *PSUB_Q_TRACK_ISRC;
  364. typedef union _SUB_Q_CHANNEL_DATA {
  365.     SUB_Q_CURRENT_POSITION CurrentPosition;
  366.     SUB_Q_MEDIA_CATALOG_NUMBER MediaCatalog;
  367.     SUB_Q_TRACK_ISRC TrackIsrc;
  368. } SUB_Q_CHANNEL_DATA, *PSUB_Q_CHANNEL_DATA;
  369. //
  370. // Audio Status Codes
  371. //
  372. #define AUDIO_STATUS_NOT_SUPPORTED  0x00
  373. #define AUDIO_STATUS_IN_PROGRESS    0x11
  374. #define AUDIO_STATUS_PAUSED         0x12
  375. #define AUDIO_STATUS_PLAY_COMPLETE  0x13
  376. #define AUDIO_STATUS_PLAY_ERROR     0x14
  377. #define AUDIO_STATUS_NO_STATUS      0x15
  378. //
  379. // ADR Sub-channel Q Field
  380. //
  381. #define ADR_NO_MODE_INFORMATION     0x0
  382. #define ADR_ENCODES_CURRENT_POSITION 0x1
  383. #define ADR_ENCODES_MEDIA_CATALOG   0x2
  384. #define ADR_ENCODES_ISRC            0x3
  385. //
  386. // Sub-channel Q Control Bits
  387. //
  388. #define AUDIO_WITH_PREEMPHASIS      0x1
  389. #define DIGITAL_COPY_PERMITTED      0x2
  390. #define AUDIO_DATA_TRACK            0x4
  391. #define TWO_FOUR_CHANNEL_AUDIO      0x8
  392. //
  393. // Get Audio control parameters
  394. //
  395. typedef struct _CDROM_AUDIO_CONTROL {
  396.     UCHAR LbaFormat;
  397.     USHORT LogicalBlocksPerSecond;
  398. } CDROM_AUDIO_CONTROL, *PCDROM_AUDIO_CONTROL;
  399. //
  400. // Volume control - Volume takes a value between 1 and 0xFF.
  401. // SCSI-II CDROM audio suppports up to 4 audio ports with
  402. // Independent volume control.
  403. //
  404. typedef struct _VOLUME_CONTROL {
  405.     UCHAR PortVolume[4];
  406. } VOLUME_CONTROL, *PVOLUME_CONTROL;
  407. typedef enum _TRACK_MODE_TYPE {
  408.     YellowMode2,
  409.     XAForm2,
  410.     CDDA
  411. } TRACK_MODE_TYPE, *PTRACK_MODE_TYPE;
  412. //
  413. // Passed to cdrom to describe the raw read, ie. Mode 2, Form 2, CDDA...
  414. //
  415. typedef struct __RAW_READ_INFO {
  416.     LARGE_INTEGER DiskOffset;
  417.     ULONG    SectorCount;
  418.     TRACK_MODE_TYPE TrackMode;
  419. } RAW_READ_INFO, *PRAW_READ_INFO;
  420. #ifdef __cplusplus
  421. }
  422. #endif
  423. #if _MSC_VER >= 1200
  424. #pragma warning(pop)          // un-sets any local warning changes
  425. #else
  426. #pragma warning(default:4200) // array[0] is not a warning for this file
  427. #pragma warning(default:4201) // nameless struct/unions
  428. #pragma warning(default:4214) // bit fields other than int
  429. #endif
  430. #endif  // _NTDDCDRM_
  431. // end_winioctl