DrvDisableSurface 함수(winddi.h)

아티클
08/27/2023

DrvDisableSurface 함수는 GDI에서 현재 디바이스에 대해 DrvEnableSurface에서 만든 표면이 더 이상 필요하지 않음을 드라이버에 알리는 데 사용됩니다.

구문

void DrvDisableSurface(
  DHPDEV dhpdev
);

매개 변수

dhpdev

물리적 디바이스의 PDEV에 대한 핸들입니다. 표면을 놓을 디바이스에 대한 핸들입니다.

반환 값

없음

설명

드라이버는 물리적 디바이스를 사용하지 않도록 설정되는 즉시 PDEV와 연결된 표면에서 사용하는 모든 메모리 및 리소스를 해제해야 합니다.

DrvAssertMode 호출로 드라이버를 사용하지 않도록 설정한 경우 다른 활성 PDEV가 사용 중일 수 있으므로 DrvDisableSurface 중에는 드라이버가 하드웨어에 액세스하지 않아야 합니다. DrvAssertMode를 호출하는 동안 필요한 모든 하드웨어 변경이 수행되어야 합니다. 드라이버는 DrvDisableSurface에서 적절한 정리 작업을 수행할 수 있도록 DrvAssertMode에 의해 비활성화되었는지 여부를 추적해야 합니다.

물리적 디바이스에 사용 가능한 표면이 있는 경우 GDI는 DrvDisablePDEV를 호출하기 전에 DrvDisableSurface를 호출합니다.

DrvDisableSurface 는 그래픽 드라이버에 필요합니다.