Função DrvGetModes (winddi.h)

Artigo
03/04/2024

A função DrvGetModes lista os modos compatíveis com determinado dispositivo.

Sintaxe

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Parâmetros

[in] hDriver

Manipule para o driver para o qual os modos devem ser enumerados. Esse é o identificador passado no parâmetro hDriver da função DrvEnablePDEV .

cjSize

Especifica o tamanho em bytes do buffer apontado pelo pdm.

[out, optional] pdm

Ponteiro para o buffer que contém estruturas DEVMODEW para o driver preencher ou NULL.

Retornar valor

O driver deve retornar o número de bytes gravados no buffer se pdm não for NULL. Se pdm for NULL, o driver deverá retornar o número de bytes necessários para manter todos os dados do modo. O driver deverá retornar zero se ocorrer um erro.

Comentários

Essa função deve ser implementada em todos os drivers de exibição.

O Gerenciador de Janelas carrega dinamicamente todos os drivers de exibição associados a um driver de miniport (com base na chave InstalledDisplayDrivers no Registro). Cada driver de exibição é chamado para recuperar a lista de modos compatíveis com essa combinação de drivers carregados. Por exemplo, o driver de exibição VGA64K retorna apenas os modos de cor de 64K que foram retornados na lista de modos obtidos do driver de miniport.

DrvGetModes pode ser chamado antes que haja um PDEV ativo.

Consulte os exemplos de Permedia para ver uma implementação funcional de DrvGetModes.

Nota O WDK (Microsoft Windows Driver Kit) não contém os drivers de exibição de exemplo 3Dlabs Permedia2 (3dlabs.htm ) e 3Dlabs Permedia3 (Perm3.htm). Você pode obter esses drivers de exemplo do DDK (Kit de Desenvolvimento de Driver do Windows Server 2003 SP1), que você pode baixar na página DDK – Windows Driver Development Kit do site do WDHC.