Função DrvEnableDriver (winddi.h)

Artigo
03/13/2024

A função DrvEnableDriver é o ponto de entrada inicial do driver exportado pela DLL do driver. Ele preenche uma estrutura DRVENABLEDATA com o número de versão DDI de elementos gráficos do driver e os endereços de chamada de todas as funções DDI gráficas compatíveis com o driver.

Sintaxe

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Parâmetros

iEngineVersion

Identifica a versão do GDI que está em execução no momento.

cj

É o tamanho em bytes da estrutura apontada pelo pded. Se a estrutura for maior do que o esperado, os membros extras deverão ficar inalterados.

[in] pded

Ponteiro para uma estrutura DRVENABLEDATA . O GDI inicializa zero bytes cj antes da chamada. O driver preenche seus próprios dados.

Retornar valor

O valor retornado será TRUE se o driver especificado estiver habilitado. Caso contrário, ele é FALSE e um código de erro é registrado.

Comentários

DrvEnableDriver deve ser implementado em todos os drivers gráficos. Se você usar as ferramentas de build do WDK (Windows Driver Kit) e tiver definido TARGETTYPE como GDI_DRIVER (consulte Criando uma DLL de gráficos de impressora), essa função deverá ser chamada de DrvEnableDriver. Essa é a única função de driver de exibição que deve ser acessada pelo nome. Todas as outras funções do driver de exibição são acessadas por meio de ponteiros de função; portanto, seus nomes são apresentados nesta documentação como pseudonames.

Inicializações pontuais, como alocar semáforos, também podem ser executadas por essa função. O driver deve aguardar até que DrvEnablePDEV seja chamado antes de habilitar o hardware, como uma exibição.

Ao executar a verificação de versão usando o valor fornecido em iEngineVersion, o driver deve usar a constante DDI_DRIVER_VERSION_Xxx apropriada (definida em winddi.h) mostrada na tabela a seguir. Os drivers quase nunca devem marcar apenas pela igualdade, pois novas versões e versões de service pack para o sistema operacional serão lançadas no futuro. Para obter mais informações, consulte DRVENABLEDATA.

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