PFND3DDDI_GETCAPS função de retorno de chamada (d3dumddi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |