IOCTL_CDROM_GET_CONFIGURATION IOCTL(ntddcdrm.h)

CD-ROM 디바이스에서 기능 및 프로필 정보를 요청합니다.

멀티미디어 디바이스는 디바이스에 있는 미디어 유형에 따라 다른 특성을 갖습니다. 드라이버에 이러한 다양한 특성에 대해 멀티미디어 디바이스를 쿼리하는 수단을 제공하기 위해 SCSI 멀티미디어 - 3 (MMC-3) 사양은 "GET CONFIGURATION"이라는 명령을 정의합니다. 이 명령을 사용하면 드라이버가 디바이스에 대한 영구 정보와 미디어가 변경 될 때마다 달라지는 정보를 모두 쿼리할 수 있습니다. Microsoft Windows 2000 이상 운영 체제에서 드라이버는 IOCTL_CDROM_GET_CONFIGURATION 요청을 사용하여 디바이스에 이 쿼리를 보낼 수 있습니다.

IOCTL_CDROM_GET_CONFIGURATION 요청은 현재 매체에 대한 디바이스의 기능을 설명하는 설명자 목록을 반환합니다. 이러한 설명자는 "기능 설명자"와 "프로필 목록 설명자"라는 두 그룹으로 나뉩니다. 기능은 디바이스 및 관련 매체의 기능을 지정합니다. 프로필은 기능의 컬렉션입니다. 디바이스가 프로필을 지원하는 경우 프로필의 모든 기능을 지원합니다.

기능 및 프로필에 대한 자세한 내용은 MMC-3 사양을 참조하세요.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

입력 버퍼.

입력 버퍼 길이

IO_STACK_LOCATION 구조의 Parameters.DeviceIoControl.InputBufferLength는 입력 버퍼의 크기(바이트)를 나타내며, 이는 = sizeof(GET_CONFIGURATION_IOCTL_INPUT)여야 합니다.

출력 버퍼

드라이버는 Irp-AssociatedIrp.SystemBuffer>의 버퍼에 있는 기능 및 프로필 데이터를 반환합니다. 데이터는 GET_CONFIGURATION_HEADER 형식의 헤더로 시작합니다. 기능 데이터는 이 헤더 바로 다음 공간에 보고됩니다. 해당 크기와 서식은 보고되는 기능에 따라 달라집니다.

출력 버퍼 길이

I/O 스택 위치의 Parameters.DeviceIoControl.OutputBufferLength는 = sizeof(GET_CONFIGURATION_HEADER)여야 >하는 버퍼의 크기를 바이트 단위로 나타냅니다.

상태 블록

정보 필드는 반환되는 바이트 수로 설정됩니다. 요청이 성공하면 상태 필드가 STATUS_SUCCESS 설정됩니다. Parameters.DeviceIoControl.InputBufferLength에 올바른 값이 없으면 STATUS_INFO_LENGTH_MISMATCH 오류와 함께 요청이 실패합니다. Parameters.DeviceIoControl.OutputBufferLength가 충분히 크지 않으면 STATUS_BUFFER_TOO_SMALL 오류와 함께 요청이 실패합니다. 출력 버퍼의 값이 너무 크면 요청이 STATUS_INVALID_BUFFER_SIZE 메시지에 실패합니다.

요구 사항

요구 사항	값
헤더	ntddcdrm.h(Ntddcdrm.h 포함)

추가 정보

GET_CONFIGURATION_HEADER

GET_CONFIGURATION_IOCTL_INPUT