Compartilhar via

Estrutura DRVENABLEDATA (winddi.h)

  • Artigo

A estrutura DRVENABLEDATA contém um ponteiro para uma matriz de estruturas DRVFN e o número de versão DDI gráfico de um sistema operacional baseado em NT.

Sintaxe

typedef struct tagDRVENABLEDATA {
  ULONG iDriverVersion;
  ULONG c;
  DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;

Membros

iDriverVersion

Especifica o número de versão DDI gráfico do sistema operacional baseado em NT para o qual o driver é direcionado. Esse membro pode ser definido como um dos seguintes valores:

Valor Versão do sistema operacional
DDI_DRIVER_VERSION_NT4 Windows NT 4.0
DDI_DRIVER_VERSION_SP3 Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5 Windows 2000
DDI_DRIVER_VERSION_NT5_01 Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1 Windows XP Service Pack 1
 

Consulte a seção Comentários para obter mais informações.

c

Especifica o número de estruturas DRVFN no buffer apontado pelo membro pdrvfn .

pdrvfn

Ponteiro para um buffer que contém uma matriz de estruturas DRVFN .

Comentários

Para ser executado nessas versões de sistemas operacionais baseados em NT, o membro iDriverVersion deve ser definido da seguinte maneira:

Versão do Windows Valor de iDriverVersion
Windows NT 4.0 iDriverVersion == DDI_DRIVER_VERSION_NT4
Windows NT 4.0 SP3 <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_SP3
Windows 2000 <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5
Windows XP <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01
Windows XP SP1 <DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01_SP1
 

Como mostra a tabela, um driver poderá ser executado em qualquer uma dessas versões do sistema operacional se iDriverVersion estiver definido como DDI_DRIVER_VERSION_NT4, mas um driver só poderá ser executado no Windows XP e em versões posteriores do sistema operacional se iDriverVersion estiver definido como DDI_DRIVER_VERSION_NT5_01.

Nota Se um driver implementar uma DDI de elementos gráficos DrvXxx sem suporte em todas as versões do Windows, o driver não poderá especificar uma entrada DRVFN para essa DDI gráfica ao executar em versões do Windows que não dão suporte a ela. Se o driver especificar uma entrada DRVFN para essa DDI gráfica, o Windows rejeitará o driver. O exemplo permedia2 demonstra como especificar diferentes estruturas DRVFN para diferentes versões do Windows.
 

Requisitos

Requisito Valor
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

DRVFN

DrvEnableDriver