PFND3DDDI_GETCAPS função de retorno de chamada (d3dumddi.h)

Artigo
02/23/2024

O runtime D3D chama a função de retorno de chamada PFND3DDDI_GETCAPS do driver para consultar os recursos do adaptador gráfico.

Sintaxe

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

Parâmetros

hAdapter

Um identificador que identifica o adaptador gráfico.

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDIARG_GETCAPS que descreve os recursos a serem recuperados.

Retornar valor

PFND3DDDI_GETCAPS retorna um dos seguintes valores:

Código de retorno	Descrição
S_OK	As funcionalidades foram recuperadas com êxito.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS não pôde alocar a memória necessária para que ela fosse concluída.

Comentários

Os dados retornados no membro pData da estrutura D3DDDIARG_GETCAPS dependem do tipo de dados solicitado (ou seja, os dados dependem de D3DDDIARG_GETCAPS. Digite e, às vezes, no membro pInfo ).

A tabela a seguir tem dois exemplos de como configurar a chamada PFND3DDDI_GETCAPS , dependendo do valor de D3DDDIARG_GETCAPS. Digite.

membro D3DDDIARG_GETCAPS	Exemplo 1	Exemplo 2
Tipo	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL (nenhuma condição está definida)	[in] NULL (nenhuma condição está definida)
pData	[out] DDRAW_CAPS (ponteiro exclusivo)	[out] UINT* (ponteiro exclusivo)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
Observações	O driver deve preencher a estrutura DDRAW_CAPS com os recursos do DirectDraw aos quais ele dá suporte.	O driver deve preencher o buffer apontado por pData com um valor UINT que representa o número de D3DDDIFORMAT formatos de superfície compatíveis com o dispositivo.

Consulte D3DDDIARG_GETCAPS para obter explicações de outros valores para D3DDDIARG_GETCAPS. Tipo usado para sobreposições de vários planos.

Simple_instancing

Se um driver direct3D de nível 9 que dá suporte ao WDDM (Modelo de Driver de Vídeo) do Windows 1.3 e posterior concluir uma chamada para PFND3DDDI_GETCAPS e retornar S_OK mas não alterar os dados na estrutura D3DDDIARG_GETCAPS , isso indicará ao runtime do Direct3D que o hardware e o driver não dão suporte a instanciação simples. Para obter mais informações, consulte D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.