WdfDriverIsVersionAvailable-Funktion (wdfdriver.h)
[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