estrutura UMDF_VERSION_DATA (wudfddi_types.h)

  • Artigo

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

A estrutura UMDF_VERSION_DATA descreve uma versão da estrutura.

Sintaxe

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

Membros

MajorNumber

Um número que especifica a versão principal da estrutura.

MinorNumber

Um número que especifica a versão secundária da estrutura.

ServiceNumber

Um número que especifica o serviço da estrutura.

Comentários

Um driver UMDF fornece um ponteiro para uma estrutura UMDF_VERSION_DATA para o método IWDFDriver::IsVersionAvailable para descrever a versão mínima da estrutura à qual o driver dá suporte.

ObservaçãoAviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.
 

Microsoft_WDF_UMDF_Version é uma variável global do tipo UMDF_VERSION_DATA que especifica a versão principal, a versão secundária e o número de serviço para a versão atual da estrutura.

Por exemplo, em Windows 8, Wudfddi.h especifica:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

Quando você compila um driver usando Wudfddi.h, Microsoft_WDF_UMDF_Version é incluído no binário do driver e exportado usando __declspec(dllexport).

Quando o sistema carrega o driver, o processo de host (WUDFHost.exe) verifica se a versão principal do driver corresponde à versão principal da estrutura e se a versão secundária do driver é menor ou igual à versão secundária da estrutura.

O driver não precisa tomar nenhuma ação para fornecer esse número de versão para a estrutura, além de compilar com Wudfddi.h.

Fim do suporte: indisponível no UMDF 2.0 e posterior.

Versão mínima do UMDF: 1.0

Cabeçalho: Wudfddi.h (include Wudfddi.h)

Requisitos

Requisito Valor
Cabeçalho wudfddi_types.h (inclua Wudfddi_types.h)

Confira também

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version