Fungsi WdfDriverIsVersionAvailable (wdfdriver.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfDriverIsVersionAvailable mengembalikan nilai Boolean yang menunjukkan apakah driver berjalan dengan versi tertentu dari pustaka Kernel-Mode Driver Framework.

Sintaks

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

Parameter

[in] Driver

Handel ke objek driver kerangka kerja driver yang diperoleh driver dari panggilan sebelumnya ke WdfDriverCreate atau WdfGetDriver.

[in] VersionAvailableParams

Penunjuk ke struktur WDF_DRIVER_VERSION_AVAILABLE_PARAMS yang mengidentifikasi versi pustaka kerangka kerja.

Nilai kembali

WdfDriverIsVersionAvailable mengembalikan TRUE jika driver berjalan dengan versi pustaka yang ditentukan parameter VersionAvailableParams .

Metode mengembalikan FALSE jika driver tidak berjalan dengan versi pustaka yang ditentukan atau jika struktur WDF_DRIVER_VERSION_AVAILABLE_PARAMS tidak valid.

Pemeriksaan bug sistem terjadi jika handel Driver tidak valid.

Keterangan

Untuk informasi selengkapnya tentang versi pustaka, lihat Penerapan Versi Pustaka Kerangka Kerja.

Contoh

Contoh kode berikut melaporkan kesalahan jika mendeteksi nomor versi pustaka yang tidak terduga.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

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

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfdriver.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverBuat

WdfDriverRetrieveVersionString

WdfGetDriver