EngModifySurface 함수(winddi.h)

EngModifySurface 함수는 드라이버에서 만든 표면의 특성에 대해 GDI에 알립니다.

구문

ENGAPI BOOL EngModifySurface(
  HSURF  hsurf,
  HDEV   hdev,
  FLONG  flHooks,
  FLONG  flSurface,
  DHSURF dhsurf,
  VOID   *pvScan0,
  LONG   lDelta,
  VOID   *pvReserved
);

매개 변수

hsurf

수정할 표면에 대한 핸들입니다. 이 매개 변수는 EngCreateDeviceBitmap 또는 EngCreateDeviceSurface 또는 SURFOBJ 구조체의 hsurf 멤버에서 반환되는 표면 핸들입니다.

hdev

표면이 연결될 디바이스에 대한 핸들입니다. 이는 GDI가 DrvCompletePDEV에 전달한 핸들입니다.

flHooks

지정된 표면에서 GDI 드로잉이 발생할 때마다 드라이버가 후크할 수 있는 함수를 제어하는 플래그 집합입니다. EngAssociateSurface 참조 페이지에 나열된 HOOK_Xxx 값 중 비트 OR일 수 있습니다.

flSurface

표면의 특성을 설명하는 플래그 집합입니다. 현재 드라이버는 화면이 비디오 메모리에 있을 때 이를 MS_NOTSYSTEMMEMORY 설정해야 합니다.

dhsurf

드라이버의 표면을 식별합니다. 드라이버는 이를 모든 항목으로 설정할 수 있습니다. GDI는 함수가 성공하면 결과 표면의 SURFOBJ 구조체의 dhsurf 멤버를 이 값으로 설정합니다.

pvScan0

비트맵 시작의 가상 주소에 대한 포인터입니다.

lDelta

비트맵의 가상 주소 보폭입니다. 즉, 한 비트맵 행의 시작과 다음 행 사이의 바이트 수입니다.

pvReserved

예약되어 있으며 항상 NULL로 설정해야 합니다.

반환 값

EngModifySurface 는 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다.

설명

EngModifySurface 를 사용하면 드라이버가 디바이스 관리 표면 을 수정하고 GDI에 이 표면의 특성을 알릴 수 있습니다. 이렇게 하면 드라이버가 대상 표면을 불투명에서 노노파크로 변환하여 GDI가 표면에 그릴 수 있습니다.

DIB 엔진은 pvScan0 및 lDelta 를 사용하여 표면에 직접 그립니다. 이러한 매개 변수가 NULL이면 표면이 GDI에 불투명하며 GDI는 드라이버에 의해 연결되지 않은 그리기 작업을 위해 DrvCopyBits를 호출하는 데 되돌리기.

DrvEnableSurface가 핸들을 기본 표면으로 반환한 후에는 해당 핸들에서 EngModifySurface를 호출하지 마세요. 이렇게 하면 특정 상황에서 버그 검사 발생할 수 있습니다. 자세한 내용은 Microsoft 기술 자료 문서 330248 참조하세요.

요구 사항

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

추가 정보

DrvCopyBits

EngAssociateSurface