UMDF_VERSION_DATA Struktur (wudfddi_types.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die UMDF_VERSION_DATA-Struktur beschreibt eine Version des Frameworks.

Syntax

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

Member

MajorNumber

Eine Zahl, die die Hauptversion des Frameworks angibt.

MinorNumber

Eine Zahl, die die Nebenversion des Frameworks angibt.

ServiceNumber

Eine Zahl, die den Dienst des Frameworks angibt.

Hinweise

Ein UMDF-Treiber stellt einen Zeiger auf eine UMDF_VERSION_DATA-Struktur auf die IWDFDriver::IsVersionAvailable-Methode bereit, um die Vom Treiber unterstützte Mindestversion des Frameworks zu beschreiben.

HinweisWarnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.
 

Microsoft_WDF_UMDF_Version ist eine globale Variable vom Typ UMDF_VERSION_DATA , die die Hauptversion, Nebenversion und Die Dienstnummer für das aktuelle Release des Frameworks angibt.

Beispielsweise gibt Wudfddi.h in Windows 8 Folgendes an:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Wenn Sie einen Treiber mithilfe von Wudfddi.h kompilieren, ist Microsoft_WDF_UMDF_Version in der Treiberbinärdatei enthalten und mit __declspec(dllexport)exportiert.

Wenn das System Ihren Treiber lädt, überprüft der Hostprozess (WUDFHost.exe), ob die Hauptversion des Treibers der Hauptversion des Frameworks entspricht und dass die Nebenversion des Treibers kleiner oder gleich der Nebenversion des Frameworks ist.

Der Treiber muss keine Maßnahmen ergreifen, um diese Versionsnummer für das Framework bereitzustellen, außer mit Wudfddi.h zu erstellen.

Ende des Supports: In UMDF 2.0 und höher nicht verfügbar.

Minimale UMDF-Version: 1.0

Header: Wudfddi.h (include Wudfddi.h)

Anforderungen

Anforderung Wert
Header wudfddi_types.h (einschließlich Wudfddi_types.h)

Weitere Informationen

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version