WdfDriverIsVersionAvailable-Funktion (wdfdriver.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WdfDriverIsVersionAvailable-Methode gibt einen booleschen Wert zurück, der angibt, ob der Treiber mit einer angegebenen Version der Kernel-Mode Driver Framework-Bibliothek ausgeführt wird.

Syntax

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

Parameter

[in] Driver

Ein Handle für das Frameworktreiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver abgerufen hat.

[in] VersionAvailableParams

Ein Zeiger auf eine WDF_DRIVER_VERSION_AVAILABLE_PARAMS-Struktur , die eine Version der Frameworkbibliothek identifiziert.

Rückgabewert

WdfDriverIsVersionAvailable gibt TRUE zurück, wenn der Treiber mit der Version der Bibliothek ausgeführt wird, die der Parameter VersionAvailableParams angibt.

Die -Methode gibt FALSE zurück, wenn der Treiber nicht mit der angegebenen Bibliotheksversion ausgeführt wird oder wenn die WDF_DRIVER_VERSION_AVAILABLE_PARAMS-Struktur ungültig ist.

Wenn das Treiberhandle ungültig ist, tritt eine Systemfehlerprüfung auf.

Hinweise

Weitere Informationen zu Bibliotheksversionen finden Sie unter Versionsverwaltung der Frameworkbibliothek.

Beispiele

Im folgenden Codebeispiel wird ein Fehler gemeldet, wenn eine unerwartete Versionsnummer der Bibliothek erkannt wird.

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdriver.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverErstellen

WdfDriverRetrieveVersionString

WdfGetDriver

Freigeben über