EngCreateDriverObj 함수(winddi.h)

EngCreateDriverObj 함수는 DRIVEROBJ 구조를 만듭니다.

구문

ENGAPI HDRVOBJ EngCreateDriverObj(
  PVOID       pvObj,
  FREEOBJPROC pFreeObjProc,
  HDEV        hdev
);

pvObj

DRIVEROBJ 구조체에서 추적할 드라이버 리소스에 대한 포인터입니다. 리소스는 현재 클라이언트 프로세스와 연결됩니다.

pFreeObjProc

pvObj가 가리키는 리소스를 해제하는 드라이버 제공 콜백 함수에 대한 포인터입니다. 콜백 함수는 다음과 같이 정의해야 합니다. 여기서 pDriverObj 는 DRIVEROBJ 구조를 가리킵니다.

BOOL CALLBACK DrvobjFreeObjProc(DRIVEROBJ *pDriverObj);

hdev

개체와 연결된 물리적 디바이스에 대한 핸들입니다. 이 매개 변수는 드라이버의 DrvCompletePDEV 함수에서 받은 GDI 핸들입니다.

반환 값은 함수가 성공한 경우 새로 만든 DRIVEROBJ 구조를 식별하는 핸들입니다. 그렇지 않으면 0입니다.

이 구조는 리소스 할당 프로세스가 먼저 정리하지 않고 종료되는 경우 해제해야 하는 디바이스 관리 리소스를 추적하는 데 사용됩니다.

드라이버는 EngDeleteDriverObj를 호출하여 DRIVEROBJ 구조를 명시적으로 삭제할 수 있습니다. 그렇지 않으면 엔진은 DRIVEROBJ를 만든 프로세스가 종료되면 pFreeObjProc 에서 가리키는 함수를 호출하여 리소스를 해제합니다.

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