IoWritePartitionTableEx 함수(ntddk.h)
IoWritePartitionTableEx 루틴은 지정된 디바이스 개체가 나타내는 디스크의 각 파티션에 대한 파티션 목록 버퍼의 항목에서 파티션 테이블을 씁니다.
구문
NTSTATUS IoWritePartitionTableEx(
[in] PDEVICE_OBJECT DeviceObject,
_DRIVE_LAYOUT_INFORMATION_EX *DriveLayout
);
매개 변수
[in] DeviceObject
파티션 테이블을 작성할 디스크를 나타내는 디바이스 개체에 대한 포인터입니다.
DriveLayout
파티션 목록 항목이 포함된 드라이브 레이아웃 버퍼에 대한 포인터입니다. 자세한 내용은 DRIVE_LAYOUT_INFORMATION_EX 참조하세요.
반환 값
IoWritePartitionTableEx는 모든 쓰기가 오류 없이 완료된 경우 STATUS_SUCCESS 상태 코드를 반환합니다. 오류가 발생할 경우 IoWritePartitionTableEx 에서 반환된 오류 코드에는 다음 목록이 포함될 수 있지만 이에 국한되지는 않습니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_DEVICE_NOT_READY | 오류가 올바른 디스크 기하 도형을 읽은 것을 나타냅니다. |
| STATUS_INSUFFICIENT_RESOURCES | 필요한 리소스(예: 힙 메모리, IRP 등)를 할당하지 못했음을 나타냅니다. |
| STATUS_UNSUCCESSFUL | 섹터 0에 필요한 MBR 디스크 서명이 없음을 나타냅니다. |
설명
IoWritePartitionTableEx 는 사용되지 않는 루틴 IoWritePartitionTable을 대체합니다. 이전 루틴과 달리 GUID 파티션 테이블과 마스터 부팅 레코드 파티션 테이블에 쓸 수 있습니다.
IoWritePartitionTableEx 는 디스크 드라이버에서만 사용해야 합니다. 다른 드라이버는 IOCTL_DISK_SET_DRIVE_LAYOUT_EX 디스크 I/O 요청을 대신 사용해야 합니다.
디스크 디바이스 드라이버가 파티션 테이블 항목에서 파티션 형식을 설정하거나 디스크를 다시 분할하는 IRP_MJ_DEVICE_CONTROL 요청을 받으면 IoWritePartitionTableEx를 호출해야 합니다. 디바이스 제어 요청은 일반적으로 컴퓨터의 파티션 및 디스크에서 I/O 제어 함수를 수행하는 형식 유틸리티에 의해 발급됩니다.
파티션 유형을 다시 설정하기 위해 드라이버는 물리적 디스크를 나타내는 디바이스 개체에 대한 포인터와 형식 유틸리티가 열려 있는 디바이스 개체와 연결된 파티션 수를 전달합니다. 디스크를 동적으로 다시 분할하려면 디스크 드라이버가 현재 디스크 파티션을 나타내는 디바이스 개체 집합을 분해하고 디스크의 새 파티션을 나타내는 새 디바이스 개체 집합을 만들어야 합니다.
파티션을 만들거나 삭제하려면 IoReadPartitionTableEx를 호출하여 시스템에 대한 전체 설명을 가져와야 합니다. 디스크의 새 구성을 반영하도록 시스템 형식 유틸리티에서 드라이브 레이아웃 구조를 수정할 수 있습니다.
IoWritePartitionTableEx 는 동기적입니다. 디스크 드라이버의 Dispatch 루틴 또는 드라이버 스레드에서 호출해야 합니다. 따라서 디바이스에 대한 파티션 유형을 다시 설정하기 위해 디바이스 제어 요청을 실행할 때 모든 사용자 및 파일 시스템 스레드가 대기 상태를 입력할 수 있도록 준비해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntddk.h(Ntddk.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |