structure UMDF_VERSION_DATA (wudfddi_types.h)

Article
08/08/2023

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La structure UMDF_VERSION_DATA décrit une version de l’infrastructure.

Syntaxe

typedef struct UMDF_VERSION_DATA {
  ULONG MajorNumber;
  ULONG MinorNumber;
  ULONG ServiceNumber;
} UMDF_VERSION_DATA, *PUMDF_VERSION_DATA;

Membres

MajorNumber

Nombre qui spécifie la version principale de l’infrastructure.

MinorNumber

Nombre qui spécifie la version mineure de l’infrastructure.

ServiceNumber

Nombre qui spécifie le service de l’infrastructure.

Remarques

Un pilote UMDF fournit un pointeur vers une structure UMDF_VERSION_DATA vers la méthode IWDFDriver ::IsVersionAvailable pour décrire la version minimale de l’infrastructure prise en charge par le pilote.

RemarqueAvertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.

Microsoft_WDF_UMDF_Version est une variable globale de type UMDF_VERSION_DATA qui spécifie la version principale, la version mineure et le numéro de service pour la version actuelle de l’infrastructure.

Par exemple, dans Windows 8, Wudfddi.h spécifie :

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Lorsque vous compilez un pilote à l’aide de Wudfddi.h, Microsoft_WDF_UMDF_Version est inclus dans le fichier binaire du pilote et exporté à l’aide de __declspec(dllexport).

Lorsque le système charge votre pilote, le processus hôte (WUDFHost.exe) vérifie que la version principale du pilote correspond à la version principale de l’infrastructure et que la version mineure du pilote est inférieure ou égale à la version mineure du framework.

Le pilote n’a pas besoin d’entreprendre d’action pour fournir ce numéro de version à l’infrastructure, autre que la génération avec Wudfddi.h.

Fin de la prise en charge : indisponible dans UMDF 2.0 et versions ultérieures.

Version minimale d’UMDF : 1.0

En-tête : Wudfddi.h (inclure Wudfddi.h)

Configuration requise

Condition requise	Valeur
En-tête	wudfddi_types.h (include Wudfddi_types.h)

Voir aussi

IWDFDriver ::IsVersionAvailable

Microsoft_WDF_UMDF_Version

Share via