Fungsi WdfDriverRetrieveVersionString (wdfdriver.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfDriverRetrieveVersionString mengambil string Unicode yang mengidentifikasi versi Kernel-Mode Driver Framework yang dijalankan driver.

Sintaks

NTSTATUS WdfDriverRetrieveVersionString(
  [in] WDFDRIVER Driver,
  [in] WDFSTRING String
);

Parameter

[in] Driver

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

[in] String

Handel ke objek string kerangka kerja yang diperoleh driver dari panggilan sebelumnya ke WdfStringCreate. Kerangka kerja menetapkan string versi ke objek string.

Nilai kembali

WdfDriverRetrieveVersionString mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Kerangka kerja tidak dapat mengalokasikan buffer untuk string Unicode.

Metode ini mungkin juga mengembalikan nilai NTSTATUS lainnya.

Pemeriksaan bug sistem terjadi jika handel Driver tidak valid.

Keterangan

Driver Anda dapat memanggil WdfDriverRetrieveVersionString jika Anda ingin menampilkan string yang mengidentifikasi versi pustaka kerangka kerja. Format string mungkin berubah dari satu versi ke versi lainnya, sehingga driver tidak boleh mencoba menginterpretasikan format atau konten string.

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

Contoh

Contoh kode berikut membuat objek string, menetapkan string versi ke objek , dan menampilkan string jika debugger berjalan.

WDFSTRING string;
UNICODE_STRING us;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveVersionString(
                                            driver,
                                            string
                                            );
    if (NT_SUCCESS(status)) {
        WdfStringGetUnicodeString(
                                  string,
                                  &us
                                  );
        DbgPrint(
                 "WDF Version string:  %wZ\n",
                 &us
                 );
    }
    WdfObjectDelete(string);
}

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)