estrutura D3DDDIDEVINFO_VCACHE (d3dumddi.h)

Artigo
08/07/2023

A estrutura D3DDDIDEVINFO_VCACHE descreve as informações de cache de vértice de um dispositivo.

Sintaxe

typedef struct _D3DDDIDEVINFO_VCACHE {
  [out] UINT Pattern;
  [out] UINT OptMethod;
  [out] UINT CacheSize;
  [out] UINT MagicNumber;
} D3DDDIDEVINFO_VCACHE;

Membros

[out] Pattern

O padrão de bit. O driver deve especificar o padrão de bit como um valor FOURCC (código de quatro caracteres) CACH. O driver pode usar a seguinte macro MAKEFOURCC para especificar o valor FOURCC como CACH:

MAKEFOURCC('C', 'A', 'C', 'H');

[out] OptMethod

O método de otimização de malha. O driver pode usar um dos valores a seguir para especificar a otimização de malha que ele usa.

Valor	Significado
D3DXMESHOPT_STRIPREORDER (0)	Otimização de faixas mais longas
D3DXMESHOPT_VCACHE (1)	Otimização baseada em cache de vértice

[out] CacheSize

O tamanho efetivo, em entradas, para o qual o driver otimiza o cache de vértice. O tamanho real do cache não é necessário para ser o tamanho especificado no CacheSize porque o tamanho real do cache é maior na maioria das situações. O driver especifica um tamanho otimizado no CacheSize somente se ele também especificar D3DXMESHOPT_VCACHE no membro OptMethod .

[out] MagicNumber

O número que deve ser usado como parte de um procedimento de tentativa e erro ao determinar quando reiniciar a lista de faixas. Esse número pode ser de 1 para o valor especificado no membro CacheSize . Normalmente, os melhores valores estão próximos de CacheSize/2. O driver especificará um número em MagicNumber somente se ele também especificar D3DXMESHOPT_VCACHE no membro OptMethod .

Comentários

Runtime do Direct3D versão 9.0 e posterior. O runtime do Microsoft Direct3D chama a função CreateQuery do driver para criar recursos do lado do driver para a consulta de cache de vértice. Nesta chamada CreateQuery , o runtime especifica o tipo de consulta D3DDDIQUERYTYPE_VCACHE no membro QueryType da estrutura D3DDDIARG_CREATEQUERY . O driver deve alocar uma estrutura D3DDDIDEVINFO_VCACHE. Em seguida, o runtime chama a função IssueQuery do driver para processar a consulta de cache de vértice. O driver deve inserir uma instrução de GPU (unidade de processamento gráfico) para gravar os dados de cache de vértice em uma alocação. Para recuperar as informações de cache de vértice do driver, o runtime chama a função GetQueryData do driver. Nesta chamada GetQueryData , o driver deve bloquear a alocação e retornar os dados de cache de vértice no membro pData da estrutura D3DDDIARG_GETQUERYDATA apontada pelo parâmetro pData .

Somente a versão 8.1 do runtime do Direct3D. O runtime do Direct3D chama a função GetInfo do driver para obter informações de cache de vértice do driver. Nesta chamada GetInfo , o runtime passa o sinalizador D3DDDIDEVINFOID_VCACHE no parâmetro DevInfoID . O driver especifica informações de cache de vértice em uma estrutura D3DDDIDEVINFO_VCACHE e as retorna no parâmetro pDevInfoStruct .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	d3dumddi.h (inclua D3dumddi.h)