D3DM_GETADAPTERINFO_DATA

9/8/2008

Essa estrutura é usada para descrever o padrão propriedades de um dispositivo de elementos gráficos. Um ponteiro para essa estrutura é passado como um parâmetro da D3DM_GetAdapterInfo função. O D3DM_GETINFO_DATA estrutura é usada para fornecer informações adicionais.

Syntax

typedef struct _D3DM_GETADAPTERINFO_DATA {
  D3DMADAPTER_IDENTIFIER* pIdentifier;
  D3DMCAPS* pCaps;
  ULONG cDisplayMode;
  D3DMDISPLAYMODE* pDisplayMode;
  ULONG nCurrentMode;
  ULONG nFormat;
  D3DMDEVICEFORMAT* pFormat;
  ULONG nMultisample;
  D3DMMULTISAMPLE_TYPE* pMultisample;
  ULONG nProfile;
  D3DMPROFILE* pProfile;
  ULONG cTotalVRam;
  ULONG cCurrentVRam;
  HRESULT rval;
} D3DM_GETADAPTERINFO_DATA;

Os membros

• pIdentifier
  Um ponteiro para um D3DMADAPTER_IDENTIFIER estrutura contendo informações such as do o driver Nome, versão e Fabricante.

• pCaps
  Um ponteiro para um D3DMCAPS estrutura cujos valores membros descrevem os recursos do driver um Direct3D Mobile.

• cDisplayMode
  Um valor ULONG one-Based descrevendo o número dos modos exibir que suporta um driver. Atualmente, Mobile Direct3D suporta apenas drivers com um único modo de exibição; Portanto, portanto, esse valor deve sempre ser 1.

• pDisplayMode
  Um ponteiro para uma matriz de D3DMDISPLAYMODE estruturas que é cDisplayMode Elementos longos. Cada elemento da matriz descreve as propriedades de um dos com suporte do driver exibir modos. A Middleware Mobile Direct3D será garantir que haja memória suficiente alocada para essa matriz.

• nCurrentMode
  Um valor baseado em zero ULONG identificando atual do driver modo de exibição a partir de modos listados na pDisplayMode matriz.    Atualmente, Mobile Direct3D suporta apenas drivers com um único modo de exibição; Portanto, esse valor deve ser sempre 0.

• nFormato
  Um valor ULONG one-Based que identifica o número de formatos de superfície que oferece suporte a um driver.

• pFormat
  Um ponteiro para uma matriz de D3DMDEVICEFORMAT estruturas que é nFormato Elementos longos. Cada elemento da matriz descreve as propriedades de um dos com suporte do driver de formatos. Isso inclui formatos para a reserva frontal, buffer de fundo, mapa (n.); mapear (v.) de textura, reserva vértice, reserva índice, reserva profundidade ou estêncil e reserva de rascunho. O driver deve também marca o formato com os bits de uso que descrevem o que é útil para o formato. Certos formatos, como índice e formatos reserva vértice, só devem ser marcados com o sinalizador D3DMUSAGE_LOCKABLE (consulte Valores D3DMUSAGE) se apropriado. A Middleware irá garantir que haja memória suficiente alocada para essa matriz.

• nMultisample
  Um valor ULONG one-Based que identifica o número dos modos multisampling que suporta um driver. Mesmo se o driver não suporte qualquer modos multisampling, esse valor serão ainda ser 1, pois o modo D3DMMULTISAMPLE_NONE deve ser sempre com suporte.

• pMultisample
  Um ponteiro para uma matriz de D3DMMULTISAMPLE_TYPE enumeração valores que é nMultisample Elementos longos. Cada elemento da matriz um identifica um dos com suporte do driver de tipos de multisampling. D3DMMULTISAMPLE_NONE deve ser sempre com suporte. A Middleware Mobile Direct3D será garantir que haja memória suficiente alocada para essa matriz.

• nPerfil
  Um valor ULONG one-Based que identifica o número de perfis que suporta o driver. Todos os drivers devem suporte a D3DMPROFILE_BASE; Portanto, esse valor deve ser sempre pelo menos 1.

• pProfile
  Um ponteiro para e matriz de D3DMPROFILE enumeração valores que é nPerfil Elementos longos. Cada elemento da matriz identifica um dos com suporte do driver de perfis. Todos os drivers devem suporte D3DMPROFILE_BASE. A Middleware Mobile Direct3D será garantir que haja memória suficiente alocada para essa matriz.

• cTotalVRam
  Um valor ULONG identificando o disponível total quantidade de memória no vídeo do driver de memória pool. Este valor não inclui a memória exibição primária ou as partes do heap alocados pelo GDI. Este valor será 0 se o dispositivo usa uma arquitetura memória compartilhada ou unificado.

• cCurrentVRam
  Um valor ULONG identificando a quantidade de vídeo atualmente memória disponível. Este valor será 0 se o dispositivo usa uma arquitetura memória compartilhada ou unificado.

• rval
  Um valor HRESULT contendo um código de erro relatado pelo driver para descrever quaisquer problemas ele encontrados ao tentar preencher os membros dessa estrutura. Se o driver não encontrar erros, ele define esse valor como D3DM_OK para indicar êxito.

Remarks

Exceto para rval, A Middleware Mobile Direct3D pode definir qualquer membro dessa estrutura para NULL antes para passando-lo como um parâmetro para D3DM_GetAdapterInfo. Isso informa o driver que a Middleware não precisa de informações associado com esse membro; Portanto, o driver não precisa gastar tempo coleta-lo.

Requirements

Header	d3dmddk.h
Windows Embedded CE	Windows CE 5.0

See Also

Reference

Direct3D Mobile Driver Structures
D3DM_GetAdapterInfo
D3DM_GETINFO_DATA
D3DMDEVICEFORMAT

Concepts

Additional Information from the Direct3D Mobile Driver

Other Resources

D3DMADAPTER_IDENTIFIER
D3DMCAPS
D3DMDISPLAYMODE
D3DMUSAGE Values
D3DMMULTISAMPLE_TYPE
D3DMPROFILE