DrvResetPDEV 함수(winddi.h)

아티클
03/15/2023

DrvResetPDEV 함수를 사용하면 Win32 애플리케이션이 ResetDC를 호출할 때 그래픽 드라이버가 이전 PDEV 구조에서 새 PDEV 구조로 드라이버의 상태를 전송할 수 있습니다.

구문

BOOL DrvResetPDEV(
  DHPDEV dhpdevOld,
  DHPDEV dhpdevNew
);

매개 변수

dhpdevOld

원래 디바이스 PDEV 구조에 대한 호출자 제공 핸들입니다. 이 핸들은 이전에 드라이버에서 DrvEnablePDEV의 반환 값으로 제공되었습니다.

dhpdevNew

새 PDEV 구조체에 대한 호출자 제공 핸들입니다.

반환 값

함수가 성공하면 이 반환 값은 TRUE 입니다. 그렇지 않으면 FALSE이고 오류 코드가 기록됩니다.

설명

그래픽 드라이버의 DrvResetPDEV 함수는 이전(현재 사용 중인) PDEV 구조체의 내용을 기반으로 새 PDEV 구조체의 내용을 수정하는 데 사용해야 합니다.

모드 변경에 대해 알아야 하는 OpenGL 디스플레이 드라이버는 DrvResetPDEV를 구현해야 합니다. 그렇지 않으면 다른 모든 디스플레이 드라이버는 일반적으로 이 함수를 구현할 필요가 없습니다.

참고 다음 정보는 프린터 그래픽 DLL과 관련이 있습니다.

이 함수는 Win32 ResetDC 함수에 대한 애플리케이션 호출의 결과로 호출되며, 이로 인해 GDI는 드라이버의 DrvEnablePDEV 를 호출하여 새 PDEV 구조를 얻습니다. 드라이버는 인쇄 작업을 렌더링하는 동안 PDEV 구조체의 내용을 수정할 수 있으므로 DrvResetPDEV 함수를 사용하면 드라이버가 이전 PDEV 구조에서 새 구조체로 이러한 수정 내용을 전송할 수 있습니다.

프린터 그래픽 DLL이 새 PDEV 구조에 추가할 수 있는 정보 유형의 예로는 캐시된 글꼴 파일에 대한 포인터 또는 다음에 DrvStartDoc 또는 DrvStartPage 가 호출될 때 페이지 초기화가 수행되어야 하는지 여부를 나타내는 플래그가 있습니다.

인쇄 문서를 렌더링하는 동안 ResetDC 가 호출되면 프린터 그래픽 DLL은 다음과 같은 일련의 호출을 받습니다.

    dhpdevNew = DrvEnablePDEV();
    DrvResetPDEV(dhpdevOld, dhpdevNew);
    DrvDisableSurface(dhpdevOld);
    DrvDisablePDEV(dhpdevOld);
    DrvEnableSurface(dhpdevNew);
    DrvStartDoc(dhpdevNew);

문서 간에 ResetDC 가 호출되면 PDEV와 연결된 표면이 없으므로 다음 일련의 호출만 수행됩니다.

    dhpdevNew = DrvEnablePDEV();
    DrvResetPDEV(dhpdevOld,dhpdevNew);
    DrvDisablePDEV(dhpdevOld);

요구 사항


대상 플랫폼	데스크톱
머리글	winddi.h(Winddi.h 포함)

추가 정보

다음을 통해 공유