IoMakeAssociatedIrp 함수(ntddk.h)

아티클
08/07/2023

이 루틴은 파일 시스템 및 파일 시스템 필터 드라이버에서 사용하도록 예약되어 있습니다. IoMakeAssociatedIrp 루틴은 최고 수준 드라이버로 전송된 master IRP와 연결되도록 IRP를 할당하고 초기화하여 호출자가 원래 요청을 분할하고 연결된 IRP를 하위 수준 드라이버로 보낼 수 있도록 합니다.

구문

PIRP IoMakeAssociatedIrp(
  [in] PIRP  Irp,
  [in] CCHAR StackSize
);

매개 변수

[in] Irp

최상위 드라이버의 Dispatch 루틴에 입력된 master IRP에 대한 포인터입니다.

[in] StackSize

연결된 IRP에 할당할 스택 위치 수를 지정합니다. 값은 다음으로 낮은 드라이버의 디바이스 개체 의 StackSize 와 적어도 같아야 하지만 연결된 IRP는 호출자에 대한 추가 스택 위치를 가질 수 있습니다.

반환 값

IoMakeAssociatedIrp 은 연결된 IRP에 대한 포인터를 반환하거나 IRP를 할당할 수 없는 경우 NULL 포인터를 반환합니다.

설명

최상위 드라이버만 이 루틴을 호출할 수 있습니다.

I/O 관리자는 호출자가 연결된 IRP에서 IoCompletion 루틴을 설정하지 않고 IoCompletion 루틴에서 STATUS_MORE_PROCESSING_REQUIRED 반환하지 않는 한 낮은 드라이버가 모든 관련 IRP를 완료하면 자동으로 master IRP를 완료합니다. 이러한 상황에서 호출자는 해당 드라이버가 연결된 모든 IRP가 완료되었음을 확인했을 때 master IRP를 명시적으로 완료해야 합니다.

master IRP만 스레드와 연결됩니다. 연결된 IRP는 연결되지 않습니다. 이러한 이유로 I/O 관리자는 스레드가 종료될 때 연결된 IRP에 대해 취소 루틴을 호출할 수 없습니다. master IRP의 스레드가 종료되면 I/O 관리자는 master IRP의 취소 루틴을 호출합니다. Cancel 루틴은 연결된 모든 IRP를 추적하고 IoCancelIrp를 호출하여 취소합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntddk.h(Ntddk.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL