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 [dentro, fora]
Um ponteiro para uma estrutura de D3DDDIARG_GETCAPS que descreve os recursos a serem recuperados.
Valor de retorno
PFND3DDDI_GETCAPS retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
| S_OK | Os recursos foram recuperados com êxito. |
| E_OUTOFMEMORY | PFND3DDDI_GETCAPS não foi possível alocar a memória necessária para que ela fosse concluída. |
Observações
Os dados retornados no pData membro da estrutura de 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) |
| Anotações | O driver deve preencher a estrutura de DDRAW_CAPS com os recursos do DirectDraw compatíveis. | O driver deve preencher o buffer apontado por pData com um valor UINT que representa o número de formatos de superfície D3DDDIFORMAT aos quais o dispositivo dá suporte. |
Consulte D3DDDIARG_GETCAPS para obter explicações sobre outros valores para D3DDDIARG_GETCAPS. Digite que são usados para sobreposições de vários planos.
Simple_instancing
Se um driver de nível 9 do Direct3D que dá suporte ao WDDM (Modelo de Driver de Exibição 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á para o runtime do Direct3D que o hardware e o driver não dão suporte a instancamento simples. Para obter mais informações, consulte D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |