QueryWorkingSetEx 함수(psapi.h)

  • 아티클

지정된 프로세스의 주소 공간에 있는 특정 가상 주소의 페이지에 대한 확장된 정보를 검색합니다.

구문

BOOL QueryWorkingSetEx(
  [in]      HANDLE hProcess,
  [in, out] PVOID  pv,
  [in]      DWORD  cb
);

매개 변수

[in] hProcess

프로세스에 대한 핸들입니다. 핸들에는 PROCESS_QUERY_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.

[in, out] pv

PSAPI_WORKING_SET_EX_INFORMATION 구조체 배열에 대한 포인터입니다. 입력에서 배열의 각 항목은 관심 있는 가상 주소를 지정합니다. 출력 시 배열의 각 항목은 해당 가상 페이지에 대한 정보를 받습니다.

[in] cb

pv 버퍼의 크기(바이트)입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

대상 프로세스의 작업 집합으로 제한되는 QueryWorkingSet 함수와 달리 QueryWorkingSetEx 함수는 프로세스 작업 집합에 없지만 AWE 및 큰 페이지와 같은 프로세스의 일부인 주소를 쿼리하는 데 사용할 수 있습니다.

Windows 7 및 Windows Server 2008 R2부터 Psapi.h는 PSAPI 함수에 대한 버전 번호를 설정합니다. PSAPI 버전 번호는 함수를 호출하는 데 사용되는 이름과 프로그램이 로드해야 하는 라이브러리에 영향을 줍니다.

PSAPI_VERSION 2 이상인 경우 이 함수는 Psapi.h에서 K32QueryWorkingSetEx로 정의되고 Kernel32.lib 및 Kernel32.dll 내보냅니다. PSAPI_VERSION 1이면 이 함수는 Psapi.h에서 QueryWorkingSetEx로 정의되고 Psapi.lib에서 내보내고 K32QueryWorkingSetEx를 호출하는 래퍼로 Psapi.dll.

이전 버전의 Windows 및 Windows 7 이상 버전에서 실행해야 하는 프로그램은 항상 이 함수 를 QueryWorkingSetEx로 호출해야 합니다. 기호의 올바른 해상도를 보장하려면 TargetLIBS 매크로에 Psapi.lib를 추가하고 "–DPSAPI_VERSION=1"으로 프로그램을 컴파일합니다. 런타임 동적 연결을 사용하려면 Psapi.dll 로드합니다.

예제

예제는 NUMA 노드에서 메모리 할당을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista, Windows XP Professional x64 Edition [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008, Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 psapi.h
라이브러리 Windows 7 및 Windows Server 2008 R2의 Kernel32.lib; Windows 7 및 Windows Server 2008 R2의 Psapi.lib(PSAPI_VERSION=1인 경우) Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP의 Psapi.lib
DLL Windows 7 및 Windows Server 2008 R2의 Kernel32.dll Windows 7 및 Windows Server 2008 R2에서 Psapi.dll(PSAPI_VERSION=1인 경우) Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP의 Psapi.dll

추가 정보

EnumProcesses

PSAPI 함수

PSAPI_WORKING_SET_EX_INFORMATION

작업 집합 정보