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
);
Die Parameter
[in] Driver
Ein Handle für das Framework-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriverabgerufen 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 VersionAvailableParams Parameter angibt.
Die Methode gibt FALSE zurück, wenn der Treiber nicht mit der angegebenen Bibliotheksversion ausgeführt wird oder die WDF_DRIVER_VERSION_AVAILABLE_PARAMS Struktur ungültig ist.
Eine Systemfehlerüberprüfung tritt auf, wenn das Treiber- Handle ungültig ist.
Bemerkungen
Weitere Informationen zu Bibliotheksversionen finden Sie unter Framework Library Versionsverwaltung.
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 |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfdriver.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Siehe auch
WDF_DRIVER_VERSION_AVAILABLE_PARAMS