WdfDriverIsVersionAvailable 함수(wdfdriver.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfDriverIsVersionAvailable 메서드는 드라이버가 지정된 버전의 Kernel-Mode Driver Framework 라이브러리로 실행 중인지 여부를 나타내는 부울 값을 반환합니다.

구문

BOOLEAN WdfDriverIsVersionAvailable(
  [in] WDFDRIVER                            Driver,
  [in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);

매개 변수

[in] Driver

드라이버가 WdfDriverCreate 또는 WdfGetDriver 에 대한 이전 호출에서 가져온 드라이버의 프레임워크 드라이버 개체 에 대한 핸들입니다.

[in] VersionAvailableParams

프레임워크 라이브러리의 버전을 식별하는 WDF_DRIVER_VERSION_AVAILABLE_PARAMS 구조체에 대한 포인터입니다.

반환 값

드라이버가 VersionAvailableParams 매개 변수가 지정한 라이브러리 버전으로 실행 중인 경우 WdfDriverIsVersionAvailable은 TRUE를 반환합니다.

지정된 라이브러리 버전으로 드라이버가 실행되고 있지 않거나 WDF_DRIVER_VERSION_AVAILABLE_PARAMS 구조가 잘못된 경우 메서드는 FALSE 를 반환합니다.

드라이버 핸들이 잘못된 경우 시스템 버그 검사 발생합니다.

설명

라이브러리 버전에 대한 자세한 내용은 프레임워크 라이브러리 버전 관리를 참조하세요.

예제

다음 코드 예제에서는 예기치 않은 라이브러리 버전 번호를 검색하는 경우 오류를 보고합니다.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
                                 driver,
                                 &ver
                                 )) {
    DbgPrint("Unexpected library version.\n");
}

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfdriver.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver