StorPortMarkDumpMemory 함수(storport.h)

  • 아티클

미니포트는 덤프 파일 또는 최대 절전 모드 파일에 사용되는 메모리를 표시해야 합니다. 표시된 메모리는 유지되며 최대 절전 모드 작업에서 다시 시작 후 유효한 상태로 유지됩니다. 표시할 메모리는 StorPortMarkDumpMemory 호출에서 주소 및 범위 길이로 지정됩니다.

구문

ULONG StorPortMarkDumpMemory(
  [in] PVOID     HwDeviceExtension,
  [in] PVOID     Address,
  [in] ULONG_PTR Length,
  [in] ULONG     Flags
);

매개 변수

[in] HwDeviceExtension

HBA(호스트 버스 어댑터)의 하드웨어 디바이스 확장에 대한 포인터입니다.

[in] Address

표시할 메모리 범위의 시작 주소입니다.

[in] Length

표시된 메모리 범위의 길이입니다.

[in] Flags

덤프 메모리 표시 플래그입니다. Flags 매개 변수는 0이거나 다음 값만 포함해야 합니다.

값 의미
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS 주소에 제공된 주소는 시스템 가상 주소가 아닌 실제 주소입니다.

반환 값

StorPortMarkDumpMemory는 다음 상태 코드 중 하나를 반환합니다.

반환 코드 설명
STOR_STATUS_SUCCESS 루틴이 단위 특성을 성공적으로 설정했음을 나타냅니다.
STOR_STATUS_INVALID_PARAMETER Flags 매개 변수에 잘못된 플래그 값이 지정되었습니다.

설명

StorPortMarkDumpMemory 루틴은 DriverEntry 또는 HwStorFindAdapter 루틴의 미니포트 드라이버에서만 호출해야 합니다.

Length = 0이면 주소가 포함된 전체 섹션이 표시됩니다.

미니포트 드라이버는 StorPortMarkDumpMemory 를 호출하여 미니포트에서 덤프 파일 또는 최대 절전 모드 파일을 생성하는 데 사용하는 메모리가 식별되도록 해야 합니다. 최소 미니포트는 PORT_CONFIGURATION_INFORMATION DumpMode 멤버가 DUMP_MODE_MARK_MEMORY 또는DUMP_MODE_HIBER 설정된 경우 StorPortMarkDumpMemory를 호출해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
대상 플랫폼 유니버설
헤더 storport.h(Storport.h 포함)
IRQL 모두

추가 정보

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION