DrvEnableDriver 함수(winddi.h)

아티클
03/04/2024

DrvEnableDriver 함수는 드라이버 DLL에서 내보낸 초기 드라이버 진입점입니다. 드라이버의 그래픽 DDI 버전 번호와 드라이버에서 지원하는 모든 그래픽 DDI 함수의 호출 주소로 DRVENABLEDATA 구조를 채웁니다.

구문

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

매개 변수

iEngineVersion

현재 실행 중인 GDI 버전을 식별합니다.

cj

pded가 가리키는 구조체의 크기(바이트)입니다. 구조체가 예상보다 크면 추가 멤버는 수정되지 않은 상태로 두어야 합니다.

[in] pded

DRVENABLEDATA 구조체에 대한 포인터입니다. GDI는 호출 전에 cj 바이트를 0으로 초기화합니다. 드라이버는 자체 데이터를 채웁니다.

반환 값

지정된 드라이버를 사용하는 경우 반환 값은 TRUE 입니다. 그렇지 않으면 FALSE이고 오류 코드가 기록됩니다.

설명

DrvEnableDriver는 모든 그래픽 드라이버에서 구현되어야 합니다. WDK(Windows 드라이버 키트) 빌드 도구를 사용하고 TARGETTYPE을 GDI_DRIVER 설정한 경우( 프린터 그래픽 DLL 빌드 참조) 이 함수의 이름은 DrvEnableDriver여야 합니다. 이름으로 액세스해야 하는 유일한 표시 드라이버 함수입니다. 다른 모든 디스플레이 드라이버 함수는 함수 포인터를 통해 액세스됩니다. 따라서 해당 이름은 이 설명서에 가명으로 표시됩니다.

세마포 할당과 같은 일회성 초기화는 이 함수에서도 수행할 수 있습니다. 드라이버는 디스플레이와 같은 하드웨어를 사용하도록 설정하기 전에 DrvEnablePDEV 가 호출될 때까지 기다려야 합니다.

iEngineVersion에 제공된 값을 사용하여 버전 검사를 수행할 때 드라이버는 다음 표에 표시된 적절한 DDI_DRIVER_VERSION_Xxx 상수(winddi.h에 정의됨)를 사용해야 합니다. 운영 체제에 대한 새 버전 및 서비스 팩 릴리스가 나중에 릴리스될 예정이므로 드라이버는 같음을 위해 거의 검사 않아야 합니다. 자세한 내용은 DRVENABLEDATA를 참조하세요.

값	운영 체제 버전
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 서비스 팩 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP 서비스 팩 1