EngMapFile 함수(winddi.h)

EngMapFile 함수는 파일을 만들거나 열고 시스템 공간에 매핑합니다.

구문

ENGAPI PVOID EngMapFile(
  [in]  LPWSTR    pwsz,
  [in]  ULONG     cjSize,
  [out] ULONG_PTR *piFile
);

[in] pwsz

매핑할 파일의 정규화된 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 정규화된 파일 이름 문자열의 예는 L"\?? \c:\test.dat".

[in] cjSize

매핑할 파일의 바이트 수를 지정합니다.

[out] piFile

매핑이 성공한 경우 매핑된 파일에 대한 식별자를 수신하는 메모리 위치에 대한 포인터입니다. 매핑이 성공하지 못하면 메모리 위치는 값 0을 받습니다. 매핑된 파일을 해제해야 하는 경우 이 값을 EngUnmapFile에 전달해야 합니다.

EngMapFile 은 성공하면 파일의 매핑된 뷰에 대한 포인터를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

파일이 이미 있는 경우 EngMapFile 이 열리고 읽기/쓰기를 위해 매핑됩니다. 파일이 없으면 EngMapFile 에서 읽기/쓰기를 위해 파일을 만들고 매핑합니다.

cjSize 값은 다음과 같이 파일의 매핑에 영향을 줍니다.

cjSize가 0이면 GDI는 파일 전체를 매핑합니다.
cjSize가 파일 크기보다 크면 GDI는 시스템 메모리에 매핑하기 전에 파일을 cjSize 바이트 크기로 확장합니다. 파일의 원래 크기를 초과하여 확장되는 메모리의 내용에 대해 가정해서는 안 됩니다.
cjSize가 파일 크기보다 작으면 GDI는 파일을 시스템 메모리에 매핑하기 전에 cjSize 바이트 크기로 자립니다.

드라이버는 반환된 포인터를 통해 파일을 읽고 쓸 수 있습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	winddi.h(Winddi.h 포함)
라이브러리	Win32k.lib
DLL	Win32k.sys