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 。

如果 驅動程式 句柄無效，就會發生系統錯誤檢查。

備註

如需連結庫版本的詳細資訊，請參閱 Framework 連結庫版本設定。

範例

下列程式代碼範例會在偵測到非預期的連結庫版本號碼時回報錯誤。

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

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

規格需求

需求 值
目標平台 Universal
最低 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