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 du pilote framework 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 de retour

WdfDriverIsVersionAvailable retourne TRUE si le pilote s’exécute avec la version de la bibliothèque spécifiée par le paramètre VersionAvailablePara ms.

La méthode retourne FAUX 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.

Une vérification des bogues système se produit si le handle pilote n’est pas valide.

Remarques

Pour plus d’informations sur les versions de bibliothèque, consultez Framework Library Versioning.

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");
}

Spécifications

Besoin	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
En-tête	wdfdriver.h (include 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

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver