EngMapEvent 함수(winddi.h)

EngMapEvent 함수는 사용자 모드 이벤트 개체를 커널 모드에 매핑합니다.

구문

ENGAPI PEVENT EngMapEvent(
  [in] HDEV   hDev,
  [in] HANDLE hUserObject,
       PVOID  Reserved1,
       PVOID  Reserved2,
       PVOID  Reserved3
);

매개 변수

[in] hDev

이벤트와 연결된 물리적 디바이스에 대한 핸들입니다. 드라이버의 DrvCompletePDEV 함수에 hdev 매개 변수로 전달되는 GDI 핸들입니다.

[in] hUserObject

매핑할 사용자 모드 이벤트에 대한 핸들입니다.

Reserved1

시스템 사용을 위해 예약되며 NULL로 설정해야 합니다.

Reserved2

시스템 사용을 위해 예약되며 NULL로 설정해야 합니다.

Reserved3

시스템 사용을 위해 예약되며 NULL로 설정해야 합니다.

반환 값

EngMapEvent 는 성공 시 이벤트 개체에 대한 포인터를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

사용자 이벤트를 성공적으로 매핑한 후 EngMapEvent 는 자동으로 이벤트 개체를 신호 상태로 설정하고, 가능한 한 많은 대기 시간을 충족하려고 시도한 다음, 이벤트 개체를 서명되지 않은 상태로 다시 설정합니다.

매핑된 이벤트는 애플리케이션이 커널 모드 그래픽 작업이 완료될 때까지 기다릴 수 있는 메커니즘을 제공합니다. 디스플레이 드라이버 또는 비디오 미니포트 드라이버는 이벤트가 매핑된 리소스를 사용하여 완료되면 애플리케이션에 신호를 전송하므로 애플리케이션에서 리소스를 사용할 수 있습니다.

표시 및 미니포트 드라이버는 매핑된 이벤트를 기다릴 수 없지만 설정하거나 지울 수 있습니다.

드라이버는 EngMapEvent에서 반환된 이벤트 개체에서 EngUnmapEvent를 호출하여 자체 정리를 수행할 수도 있습니다.

요구 사항

추가 정보

DrvCompletePDEV

EngUnmapEvent