estructura de UMDF_VERSION_DATA (wudfddi_types.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

La estructura UMDF_VERSION_DATA describe una versión del marco de trabajo.

Sintaxis

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

Miembros

MajorNumber

Número que especifica la versión principal del marco.

MinorNumber

Número que especifica la versión secundaria del marco.

ServiceNumber

Número que especifica el servicio del marco.

Comentarios

Un controlador UMDF proporciona un puntero a una estructura de UMDF_VERSION_DATA al método IWDFDriver::IsVersionAvailable para describir la versión mínima del marco que admite el controlador.

NotaAdvertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.
 

Microsoft_WDF_UMDF_Version es una variable global de tipo UMDF_VERSION_DATA que especifica la versión principal, la versión secundaria y el número de servicio para la versión actual del marco.

Por ejemplo, en Windows 8, Wudfddi.h especifica:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Al compilar un controlador mediante Wudfddi.h, Microsoft_WDF_UMDF_Version se incluye en el archivo binario del controlador y se exporta mediante __declspec(dllexport).

Cuando el sistema carga el controlador, el proceso de host (WUDFHost.exe) comprueba que la versión principal del controlador coincide con la versión principal del marco y que la versión secundaria del controlador es menor o igual que la versión secundaria del marco.

El controlador no necesita realizar ninguna acción para proporcionar este número de versión al marco, aparte de compilar con Wudfddi.h.

Fin del soporte técnico: no disponible en UMDF 2.0 y versiones posteriores.

Versión mínima de UMDF: 1.0

Encabezado: Wudfddi.h (incluya Wudfddi.h)

Requisitos

Requisito Valor
Header wudfddi_types.h (incluya Wudfddi_types.h)

Consulte también

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version