IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL(ntddvol.h)
하나 이상의 디스크에서 볼륨의 실제 위치를 반환합니다. 익스텐트를 만든 순서대로 처음에 저장하지만 미러를 다시 감상, 분할 또는 중단하거나 재해 복구 중에 수행된 작업은 디스크 익스텐트의 순서에 영향을 줄 수 있습니다.
주 코드
입력 버퍼
없음.
입력 버퍼 길이
없음.
출력 버퍼
드라이버는 Irp->AssociatedIrp.SystemBuffer버퍼의 VOLUME_DISK_EXTENTS 구조를 반환합니다. 이 구조체는 VOLUME_DISK_EXTENTS(sizeof )이상이어야 합니다.
출력 버퍼 길이
VOLUME_DISK_EXTENTS 구조체의 길이입니다.
상태 블록
드라이버는 다음과 같이 Irp->IoStatus.Information 및 상태 필드를 설정합니다.
- Irp->AssociatedIrp.SystemBuffer 버퍼가(VOLUME_DISK_EXTENTS)< 경우 드라이버는 Irp->IoStatus.Information 0으로 설정하고 STATUS_INVALID_PARAMETER 반환합니다.
- Irp->AssociatedIrp.SystemBuffer 버퍼가 크기(VOLUME_DISK_EXTENTS) 이상이지만 모든 데이터를 반환하기에는 너무 작으면 드라이버는 Irp->IoStatus.Informationsizeof(VOLUME_DISK_EXTENTS)로 설정하고 상태 STATUS_BUFFER_OVERFLOW 설정합니다.
- Irp->AssociatedIrp.SystemBuffer 버퍼가 모든 데이터가 반환될 만큼 충분히 큰 경우 드라이버는 Irp->IoStatus.Informationsizeof(VOLUME_DISK_EXTENTS) + ((NumberOfDiskExtents - 1) * sizeof(DISK_EXTENT))로 설정하고 상태 STATUS_SUCCESS 설정합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 고정 디스크의 볼륨에는 Microsoft Windows 2000에서 사용할 수 있지만 이동식 미디어의 볼륨에는 사용할 수 없습니다. Microsoft Windows 2000 SP4 및 Windows XP SP1에서 이동식 미디어에 사용할 수 있습니다. |
| 헤더 | ntddvol.h(Ntddvol.h 포함) |