WdfDriverIsVersionAvailable, fonction (wdfdriver.h)
[S’applique à KMDF et UMDF]
La méthode WdfDriverIsVersionAvailable retourne une valeur booléenne qui indique si le pilote s’exécute avec une version spécifiée de la bibliothèque Kernel-Mode Driver Framework.
Syntaxe
BOOLEAN WdfDriverIsVersionAvailable(
[in] WDFDRIVER Driver,
[in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);
Paramètres
[in] Driver
Handle de l’objet de pilote d’infrastructure du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfGetDriver.
[in] VersionAvailableParams
Pointeur vers une structure WDF_DRIVER_VERSION_AVAILABLE_PARAMS qui identifie une version de la bibliothèque d’infrastructure.
Valeur retournée
WdfDriverIsVersionAvailable retourne TRUE si le pilote s’exécute avec la version de la bibliothèque spécifiée par le paramètre VersionAvailableParams .
La méthode retourne FALSE si le pilote n’est pas en cours d’exécution avec la version de bibliothèque spécifiée ou si la structure WDF_DRIVER_VERSION_AVAILABLE_PARAMS n’est pas valide.
Un bogue système case activée se produit si le handle du pilote n’est pas valide.
Remarques
Pour plus d’informations sur les versions de bibliothèque, consultez Gestion des versions de bibliothèque d’infrastructure.
Exemples
L’exemple de code suivant signale une erreur s’il détecte un numéro de version de bibliothèque inattendu.
WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;
WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
driver,
&ver
)) {
DbgPrint("Unexpected library version.\n");
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfdriver.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Voir aussi
WDF_DRIVER_VERSION_AVAILABLE_PARAMS