ntddcdrm.h 헤더

이 헤더는 스토리지에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• 스토리지

ntddcdrm.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

IOCTLs

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은 디바이스가 IOCTL_CDROM_EXCLUSIVE_ACCESS 단독으로 잠겨 있을 때 사용할 수 있습니다.
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(프로그램 메모리 영역) 및 ATIP(pregroove)의 절대 시간을 쿼리합니다.
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 구조는 단독 액세스를 위해 CD-ROM 디바이스를 잠그는 IOCTL_CDROM_EXCLUSIVE_ACCESS 요청과 함께 사용됩니다.
CDROM_EXCLUSIVE_LOCK_STATE CDROM_EXCLUSIVE_LOCK_STATE 구조는 CD-ROM 클래스 드라이버에서 CD-ROM 디바이스의 배타적 액세스 상태를 보고하는 데 사용됩니다.
CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR CDROM_NOMINAL_PERFORMANCE_DESCRIPTOR 구조체는 호스트에 논리 단위 성능의 근사치를 제공합니다.
CDROM_PERFORMANCE_HEADER CDROM_PERFORMANCE_HEADER 구조는 IOCTL_CDROM_GET_PERFORMANCE IOCTL에서 데이터를 반환하는 데 사용됩니다. 요청 유형이 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 구조에는 제어 코드가 IOCTL_CDROM_SEEK_AUDIO_MSF 디바이스 컨트롤 IRP를 수신할 때 디바이스가 검색해야 하는 분, 초 및 프레임이 포함됩니다.
CDROM_SET_SPEED CDROM_SET_SPEED 구조는 데이터 손실이 허용되지 않는 데이터 전송 중에 CD-ROM 드라이브의 스핀들 속도를 설정하기 위해 IOCTL_CDROM_SET_SPEED 요청과 함께 사용됩니다.
CDROM_SET_STREAMING CDROM_SET_SPEED 구조는 일부 데이터 손실을 허용하는 등시 전송 중에 CD-ROM 드라이브의 스핀들 속도를 설정하기 위해 IOCTL_CDROM_SET_SPEED 요청과 함께 사용됩니다.
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 컨트롤 코드와 CDROM_READ_TOC_EX_FORMAT_CDTEXT 형식의 디바이스 제어 IRP는 출력 데이터를 이 구조체에 반환한 다음 일련의 형식 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 구조는 원시 모드에서 CD-ROM에서 데이터를 읽는 IOCTL_CDROM_RAW_READ 요청과 함께 사용됩니다.
SUB_Q_CHANNEL_DATA 제어 코드가 IOCTL_CDROM_READ_Q_CHANNEL 디바이스 제어 IRP는 이 공용 구조체에서 출력 데이터를 반환합니다.
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 구조는 최대 4개의 오디오 포트에 대한 볼륨 값을 검색하기 위해 IOCTL_CDROM_GET_VOLUME 요청과 함께 사용됩니다.

열거형

CDROM_OPC_INFO_TYPE CDROM_OPC_INFO_TYPE 열거형은 CDROM_SIMPLE_OPC_INFO 구조체의 멤버입니다. IOCTL_CDROM_SEND_OPC_INFORMATION I/O 제어 요청에 대한 입력으로 사용되는 OPC(최적 전원 보정) 요청을 정의합니다.
CDROM_PERFORMANCE_EXCEPTION_TYPE CDROM_PERFORMANCE_EXCEPTION_TYPE 열거형은 성능 데이터에 대한 예외 조건을 정의합니다.
CDROM_PERFORMANCE_REQUEST_TYPE CDROM_PERFORMANCE_REQUEST_TYPE 열거형은 성능 데이터 요청 유형을 정의합니다. IOCTL_CDROM_GET_PERFORMANCE I/O 컨트롤 요청에 대한 입력 매개 변수로 사용되는 CDROM_PERFORMANCE_REQUEST 구조체의 멤버입니다.
CDROM_PERFORMANCE_TOLERANCE_TYPE CDROM_PERFORMANCE_TOLERANCE_TYPE 열거형은 성능 데이터에 허용되는 허용 오차를 정의합니다. IOCTL_CDROM_GET_PERFORMANCE I/O 컨트롤 요청에 대한 입력 매개 변수로 사용되는 CDROM_PERFORMANCE_REQUEST 구조체의 멤버입니다.
CDROM_PERFORMANCE_TYPE CDROM_PERFORMANCE_TYPE 열거형은 읽기 및 쓰기 성능 데이터 요청을 정의합니다. IOCTL_CDROM_GET_PERFORMANCE I/O 컨트롤 요청에 대한 입력 매개 변수로 사용되는 CDROM_PERFORMANCE_REQUEST 구조체의 멤버입니다.
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(상수 각도 속도) 회전을 사용하는지 여부를 지정합니다.