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 바이트 크기로 자립니다.

요구 사항

추가 정보

EngDeleteFile

EngUnmapFile