IRP_MJ_SET_VOLUME_INFORMATION(FS 및 필터 드라이버)

아티클
02/07/2024

보낸 경우

I/O 관리자는 IRP_MJ_SET_VOLUME_INFORMATION 요청을 보냅니다. 예를 들어 사용자 모드 애플리케이션이 SetVolumeLabel과 같은 Win32 함수를 호출한 경우 전송할 수 있습니다.

작업: 파일 시스템 드라이버

파일 시스템 드라이버는 파일 개체가 열려 있는 사용자 볼륨을 나타내는지 여부를 확인하기 위해 파일 개체를 추출하고 디코딩해야 합니다. 이 경우 파일 시스템 드라이버는 적절한 볼륨 정보를 설정하고 IRP를 완료해야 합니다. 그렇지 않으면 파일 시스템은 볼륨 정보를 설정하지 않고 IRP를 적절하게 완료해야 합니다.

설정할 수 있는 볼륨 정보의 형식은 파일 시스템에 따라 달라지지만 일반적으로 다음 값 중 하나 이상을 포함합니다.

FileFsControlInformation
FileFsLabelInformation
FileFsObjectIdInformation

가능한 모든 정보 유형 목록은 ntifs.h의 FS_INFORMATION_CLASS 열거형을 참조하세요.

작업: 레거시 파일 시스템 필터 드라이버

필터 드라이버는 이 IRP를 스택의 다음 하위 드라이버로 전달해야 합니다.

매개 변수

파일 시스템 또는 필터 드라이버는 지정된 IRP에 대해 IoGetCurrentIrpStackLocation 을 호출하여 IRP의 자체 스택 위치에 대한 포인터를 가져옵니다. 다음 매개 변수에서 Irp 는 IRP 를 가리키고 IrpSp 는 IO_STACK_LOCATION 가리킵니다. 드라이버는 IRP 및 IRP 스택 위치의 다음 멤버에 설정된 정보를 사용하여 설정된 볼륨 정보 요청을 처리할 수 있습니다.

DeviceObject 는 대상 디바이스 개체에 대한 포인터입니다.
Irp->ASSOCIATedIrp.SystemBuffer는 설정할 볼륨 정보의 값을 포함하는 입력 버퍼를 가리킵니다. 이 정보는 다음 구조 중 하나에 저장됩니다.
- FILE_FS_CONTROL_INFORMATION
- FILE_FS_LABEL_INFORMATION
- FILE_FS_OBJECTID_INFORMATION
Irp->IoStatus는 최종 완료 상태 수신하는 IO_STATUS_BLOCK 구조와 요청된 작업에 대한 정보를 가리킵니다.
IrpSp->FileObject 는 DeviceObject와 연결된 파일 개체를 가리킵니다.

IrpSp-FileObject> 매개 변수에는 relatedFileObject 필드에 대한 포인터가 포함되어 있으며 이는 FILE_OBJECT 구조이기도 합니다. FILE_OBJECT 구조체의 RelatedFileObject 필드는 IRP_MJ_SET_VOLUME_INFORMATION 처리하는 동안 유효하지 않으므로 사용하면 안 됩니다.
IrpSp->MajorFunction 은 IRP_MJ_SET_VOLUME_INFORMATION 설정됩니다.

IrpSp->Parameters.SetVolume.FsInformationClass 는 볼륨에 대해 설정할 정보 유형이며 다음 중 하나일 수 있습니다.

값	의미
FileFsControlInformation	볼륨에 대한 FILE_FS_CONTROL_INFORMATION 설정합니다.
FileFsLabelInformation	볼륨에 대한 FILE_FS_LABEL_INFORMATION 설정합니다.
FileFsObjectIdInformation	볼륨에 대한 FILE_FS_OBJECTID_INFORMATION 설정합니다.