IRP_MJ_READ(FS 및 필터 드라이버)

아티클
05/30/2024

보낸 경우

I/O 관리자 또는 파일 시스템 드라이버는 IRP_MJ_READ 요청을 보냅니다. 예를 들어 사용자 모드 애플리케이션이 ReadFile과 같은 Win32 함수를 호출하거나 커널 모드 구성 요소가 ZwReadFile을 호출한 경우 이 요청을 보낼 수 있습니다.

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

파일 시스템 드라이버는 파일 개체를 추출하고 디코딩하여 매개 변수 및 부 함수 코드를 결정해야 합니다.

MDL(메모리 설명자 목록) 읽기 요청의 경우 파일 시스템에서 부 함수 코드를 검사 요청된 작업을 결정해야 합니다. 다음은 캐시된 파일 I/O에만 사용할 수 있는 유효한 부 함수 코드입니다.

IRP_MN_COMPLETE
IRP_MN_COMPLETE_MDL
IRP_MN_COMPLETE_MDL_DPC
IRP_MN_COMPRESSED
IRP_MN_DPC
IRP_MN_MDL
IRP_MN_MDL_DPC
IRP_MN_NORMAL

이 IRP 처리에 대한 자세한 내용은 WDK(Windows 드라이버 키트)에 포함된 CDFS 및 FASTFAT 샘플을 참조하세요.

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

필터 드라이버는 필요한 처리를 수행해야 하며 필터의 특성에 따라 다음 작업 중 하나를 수행해야 합니다.

IRP를 완료하거나 실패하거나
IRP를 스택의 다음 하위 드라이버로 전달합니다.

매개 변수

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

DeviceObject 는 대상 디바이스 개체에 대한 포인터입니다.
Irp-AssociatedIrp.SystemBuffer>는 deviceObject-Flags>에서 DO_BUFFERED_IO 플래그가 설정된 경우 중간 시스템 버퍼로 사용할 시스템 제공 버퍼를 가리킵니다. 그렇지 않으면 이 멤버가 NULL로 설정됩니다.
Irp-IoStatus>는 요청된 작업에 대한 최종 완료 상태 정보를 수신하는 IO_STATUS_BLOCK 구조를 가리킵니다. 자세한 내용은 ZwReadFile에 대한 IoStatusBlock 매개 변수에 대한 설명을 참조하세요.
Irp-MdlAddress>는 읽을 데이터가 포함된 페이지를 설명하는 MDL(메모리 설명자 목록)의 주소입니다.
Irp-UserBuffer>는 파일에서 읽은 데이터를 수신하는 호출자 제공 출력 버퍼를 가리킵니다.
IrpSp-FileObject>는 DeviceObject 와 연결된 파일 개체를 가리킵니다. IrpSp-FileObject-Flags>>에서 FO_SYNCHRONOUS_IO 플래그가 설정된 경우 동기 I/O를 위해 파일 개체가 열렸습니다.

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

IrpSp-MinorFunction>은 요청 중인 작업을 지정하고 다음 값 중 하나를 포함합니다. 부 함수 코드가 지정되지 않은 경우 작업은 표준 읽기(IRP_MN_NORMAL 동일)입니다.

MinorFunction	설명
IRP_MN_NORMAL	읽기 요청은 표준 읽기 작업에 대한 것입니다.
IRP_MN_DPC	읽기 요청은 DPC 루틴에서 가져옵니다.
IRP_MN_MDL	Irp-MdlAddress>에서 파일의 캐시된 데이터를 설명하는 MDL을 반환합니다. 호출자는 이 MDL을 사용하여 캐시에 직접 데이터를 읽습니다.
IRP_MN_COMPLETE	표준 읽기 작업의 완료를 나타냅니다.
IRP_MN_COMPRESSED	압축된 파일에 대한 읽기 요청입니다.
IRP_MN_MDL_DPC	읽기 요청은 DPC 루틴에서 온 것이며 Irp-MdlAddress>에서 파일의 캐시된 데이터를 설명하는 MDL을 반환합니다.
IRP_MN_COMPLETE_MDL	MDL을 사용하여 캐시에 직접 데이터를 읽은 호출자가 MDL 사용을 완료했음을 나타냅니다.
IRP_MN_COMPLETE_MDL_DPC	MDL을 사용하여 캐시에 직접 데이터를 읽은 호출자가 MDL 사용을 완료했음을 나타냅니다. 읽기 요청은 DPC 루틴에서 가져옵니다.

IrpSp-Parameters.Read.ByteOffset>은 읽을 데이터 파일 내에서 시작 바이트 오프셋을 지정하는 LARGE_INTEGER 변수입니다.
IrpSp-Parameters.Read.Key>는 대상 파일의 바이트 범위 잠금과 연결된 키 값입니다.
IrpSp-Parameters.Read.Length>는 읽을 데이터의 길이(바이트)입니다. 읽기 작업이 성공하면 Irp-IoStatus가 가리키는 IO_STATUS_BLOCK 구조의 정보 멤버에서 읽은 바이트 수가 반환됩니다.>

설명

파일 시스템은 파일 끝부분에 기본 파일 스토리지 디바이스의 섹터 크기의 배수까지 쓰기 및 읽기 작업을 반올림합니다. 필터가 사전 읽기 또는 사전 쓰기 작업을 처리하는 경우 버퍼를 할당하고 교환하는 필터는 할당된 버퍼의 크기를 연결된 디바이스의 섹터 크기의 배수로 반올림해야 합니다. 그렇지 않은 경우 기본 파일 시스템에서 전송되는 데이터의 길이가 버퍼의 할당된 길이를 초과합니다. 버퍼 교환에 대한 자세한 내용은 swapBuffers Minifilter 샘플을 참조 하세요.