다음을 통해 공유

PoFxPowerOnCrashdumpDevice 함수(wdm.h)

  • 아티클

PoFxPowerOnCrashdumpDevice 루틴은 크래시 덤프 디바이스를 켜라고 요청합니다.

구문

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

매개 변수

[in] Handle

PoFx(Windows 전원 관리 프레임워크 )를 사용하여 크래시 덤프 디바이스의 등록을 나타내는 핸들입니다. 디바이스 드라이버는 이전에 PoFxRegisterDevice 루틴에서 이 핸들을 받았습니다.

[in, optional] Context

디바이스별 컨텍스트에 대한 포인터입니다. 이 포인터는 디바이스의 PEP(플랫폼 확장 플러그 인)에서 구현하는 PowerOnDumpDeviceCallback 콜백 루틴에 입력 매개 변수로 전달됩니다. 컨텍스트 정보는 디바이스 드라이버에 의해 정의되고 PEP에서 이해되는 형식으로 저장됩니다. 이 컨텍스트는 운영 체제에 불투명합니다. PEP에 컨텍스트가 필요하지 않은 경우 드라이버는 이 매개 변수를 NULL로 설정할 수 있습니다.

반환 값

PoFxPowerOnCrashdumpDevice는 루틴이 디바이스에 전원을 켜는 데 성공하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 값 Description
STATUS_INVALID_PARAMETER
 유효한 핸들 값이 아닙니다.
STATUS_UNSUCCESSFUL
 이 디바이스의 PEP는 PowerOnDumpDeviceCallback 콜백 루틴을 구현하지 않습니다. 또는 PEP가 디바이스를 켜지 못했습니다.

설명

크래시 덤프 디바이스의 드라이버는 이 루틴을 호출하여 PEP(플랫폼 확장 플러그 인)가 크래시 덤프를 저장할 수 있도록 디바이스를 켜도록 요청합니다. 크래시 덤프 디바이스 체인의 모든 디바이스(스토리지 컨트롤러, PCI 컨트롤러 등을 포함할 수 있음)를 켜야 크래시 덤프 파일을 디스크에 쓸 수 있습니다.

크래시 덤프에 대한 자세한 내용은 커널 모드 덤프 파일을 참조하세요.

이 루틴은 IRQL <= HIGH_LEVEL 호출할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 사용하여 사용할 수 있습니다.
대상 플랫폼 Windows
헤더 wdm.h(Pepfx.h 포함)
라이브러리 Ntoskrnl.lib
IRQL <= HIGH_LEVEL

추가 정보

PoFxRegisterDevice

PowerOnDumpDeviceCallback