IoRegisterLastChanceShutdownNotification 함수(wdm.h)

IoRegisterLastChanceShutdownNotification 루틴은 모든 파일 시스템이 플러시된 후 시스템이 종료될 때 IRP_MJ_SHUTDOWN IRP를 수신하도록 드라이버를 등록합니다.

구문

NTSTATUS IoRegisterLastChanceShutdownNotification(
  [in] PDEVICE_OBJECT DeviceObject
);

매개 변수

[in] DeviceObject

드라이버가 종료 알림을 요청하는 디바이스의 디바이스 개체에 대한 포인터입니다. 시스템은 이 포인터를 드라이버의 DispatchShutdown 루틴에 전달합니다.

반환 값

IoRegisterLastChanceShutdownNotification 은 성공 시 STATUS_SUCCESS 반환하거나 실패 시 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

IoRegisterLastChanceShutdownNotification 루틴은 시스템이 종료될 때 지정된 디바이스에 대한 IRP_MJ_SHUTDOWN IRP를 수신하도록 드라이버를 등록합니다. 드라이버는 알림을 받기 위해 등록하는 각 디바이스에 대해 이러한 IRP 하나를 받습니다. 드라이버는 DispatchShutdown 루틴 내에서 IRP_MJ_SHUTDOWN IRP를 처리합니다.

이 루틴에 등록된 모든 디바이스의 경우 시스템은 모든 파일 시스템이 플러시된 후 IRP_MJ_SHUTDOWN IRP를 보냅니다. IoRegisterShutdownNotification 또는 IoRegisterLastChanceShutdownNotification을 호출하여 디바이스 스택의 드라이버 하나만 등록하여 종료 알림을 수신해야 합니다.

드라이버에서 해당 디바이스에 대한 종료 알림이 필요하지 않은 경우 IoUnregisterShutdownNotification 을 사용하여 종료 알림 큐에서 드라이버를 제거합니다.

IoRegisterLastChanceShutdownNotification을 호출하는 드라이버는 DispatchShutdown 루틴에서 다음 제한을 충족해야 합니다.

• DispatchShutdown 루틴은 페이지 가능한 루틴을 호출해서는 안 됩니다.
• DispatchShutdown 루틴은 페이지가 지정 가능한 메모리에 액세스해서는 안됩니다.
• DispatchShutdown 루틴은 파일 I/O 작업을 수행해서는 안 됩니다.

종료 알림이 필요한 대부분의 드라이버는 IoRegisterShutdownNotification 루틴을 호출해야 합니다. 이 루틴은 DispatchShutdown 루틴에 이러한 제한을 적용하지 않으며 파일 시스템이 플러시되기 전에 DispatchShutdown 루틴이 호출됩니다. 대용량 스토리지 디바이스용 드라이버와 같이 파일 시스템이 플러시된 후 일부 정리를 수행해야 하는 드라이버만 IoRegisterLastChanceShutdownNotification을 사용해야 합니다.

Power Manager가 PowerSystemShutdown에 대한 IRP_MN_SET_POWER 요청을 보내기 전에 등록된 DispatchShutdown 루틴이 호출됩니다. DispatchShutdown 루틴은 다른 전원 상태로 전환하기 위해 호출되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. Microsoft Windows 98/Me에서는 사용할 수 없습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

추가 정보

DispatchShutdown

IoRegisterShutdownNotification

IoUnregisterShutdownNotification