struttura UMDF_VERSION_DATA (wudfddi_types.h)

Articolo
08/08/2023

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

La struttura UMDF_VERSION_DATA descrive una versione del framework.

Sintassi

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

Members

MajorNumber

Numero che specifica la versione principale del framework.

MinorNumber

Numero che specifica la versione secondaria del framework.

ServiceNumber

Numero che specifica il servizio del framework.

Commenti

Un driver UMDF fornisce un puntatore a una struttura UMDF_VERSION_DATA al metodo IWDFDriver::IsVersionAvailable per descrivere la versione minima del framework supportato dal driver.

NotaAvviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.

Microsoft_WDF_UMDF_Version è una variabile globale di tipo UMDF_VERSION_DATA che specifica la versione principale, la versione secondaria e il numero di servizio per la versione corrente del framework.

Ad esempio, in Windows 8, Wudfddi.h specifica:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Quando si compila un driver usando Wudfddi.h, Microsoft_WDF_UMDF_Version è incluso nel file binario del driver ed esportato usando __declspec(dllexport).

Quando il sistema carica il driver, il processo host (WUDFHost.exe) verifica che la versione principale del driver corrisponda alla versione principale del framework e che la versione secondaria del driver sia minore o uguale alla versione secondaria del framework.

Il driver non deve eseguire alcuna azione per fornire questo numero di versione al framework, ad eccezione della compilazione con Wudfddi.h.

Fine del supporto: non disponibile in UMDF 2.0 e versioni successive.

Versione minima di UMDF: 1.0

Intestazione: Wudfddi.h (include Wudfddi.h)

Requisiti

Requisito	Valore
Intestazione	wudfddi_types.h (includere Wudfddi_types.h)

Vedi anche

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version

Condividi tramite