WDF_DRIVER_CONFIG 구조체(wdfdriver.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

WDF_DRIVER_CONFIG 구조체는 WdfDriverCreate에 대한 입력 매개 변수입니다.

구문

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

멤버

Size

이 구조체의 크기(바이트)입니다.

EvtDriverDeviceAdd

드라이버의 EvtDriverDeviceAdd 콜백 함수에 대한 포인터입니다.

EvtDriverUnload

드라이버의 EvtDriverUnload 콜백 함수에 대한 포인터입니다.

DriverInitFlags

드라이버 초기화 플래그를 식별하는 하나 이상의 WDF_DRIVER_INIT_FLAGS 형식 값의 비트 OR입니다.

DriverPoolTag

(KMDF 버전 1.5 이상) 프레임워크가 드라이버의 모든 풀 할당에 할당할 드라이버 정의 풀 태그입니다. 디버거는 이 태그를 표시합니다. 풀 태그를 지정하는 방법에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

설명

드라이버는 필요에 따라 프레임워크가 드라이버의 모든 풀 할당에 할당할 풀 태그를 지정할 수 있습니다. 드라이버는 일반적으로 한 따옴표로 구분된 최대 4자의 문자 문자열을 역순으로 지정합니다(예: 'dcba'). 태그에 있는 각 문자의 ASCII 값은 0에서 127 사이여야 합니다.

DriverPoolTag가 0인 경우 프레임워크는 드라이버 커널 모드 서비스 이름의 처음 4자를 사용하여 기본 풀 태그를 만듭니다. 서비스 이름이 "WDF"로 시작하는 경우(이름은 대/소문자를 구분하지 않고 따옴표를 포함하지 않음) 다음 네 문자가 사용됩니다. 4자 미만의 문자를 사용할 수 있는 경우 "FxDr"이 사용됩니다.

WDF_DRIVER_CONFIG 구조를 초기화하려면 드라이버가 WDF_DRIVER_CONFIG_INIT 호출해야 합니다.