EngCreateDeviceSurface 함수(winddi.h)

EngCreateDeviceSurface 함수는 드라이버가 관리할 디바이스 표면에 대한 핸들을 만들고 반환합니다.

구문

ENGAPI HSURF EngCreateDeviceSurface(
  [in] DHSURF dhsurf,
  [in] SIZEL  sizl,
       ULONG  iFormatCompat
);

[in] dhsurf

디바이스에서 관리할 표면에 대한 디바이스 핸들입니다. 이 핸들은 입력 또는 출력을 위해 SURFOBJ 구조체가 전달될 때 드라이버에 전달됩니다.

[in] sizl

만들 표면의 너비와 높이를 포함하는 SIZEL 구조를 지정합니다. 이 구조체의 cx 및 cy 멤버는 각각 표면의 너비와 높이를 픽셀 단위로 포함합니다. SIZEL 구조체는 SIZE 구조체와 동일합니다.

iFormatCompat

생성되는 디바이스 표면의 호환되는 엔진 형식을 지정합니다. 이는 복잡한 그리기 호출을 시뮬레이션하기 위해 임시 버퍼가 필요한 경우 GDI에서 사용됩니다.

반환 값은 함수가 성공한 경우 표면을 식별하는 핸들입니다. 그렇지 않으면 0이고 오류 코드가 기록됩니다.

필요에 따라 드라이버에서 표면의 저장 공간을 제공할 수 있습니다. EngAssociateSurface를 사용하여 표면을 연결해야 합니다. EngDeleteSurface를 사용하여 더 이상 필요하지 않은 경우 표면을 삭제해야 합니다.

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