Condividi tramite


PFND3DDDI_GETCAPS funzione di callback (d3dumddi.h)

Il runtime D3D chiama la funzione di callback del driver PFND3DDDI_GETCAPS per eseguire query sulle funzionalità della scheda grafica.

Sintassi

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

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

Parametri

hAdapter

Handle che identifica la scheda grafica.

unnamedParam2

pData [in, out]

Puntatore a una struttura di D3DDDIARG_GETCAPS che descrive le funzionalità da recuperare.

Valore restituito

PFND3DDDI_GETCAPS restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_OK Le funzionalità sono state recuperate correttamente.
E_OUTOFMEMORY PFND3DDDI_GETCAPS non è stato possibile allocare la memoria necessaria per il completamento.

Commenti

I dati restituiti nel membro pData della struttura D3DDDIARG_GETCAPS dipendono dal tipo di dati richiesti, ovvero i dati dipendono da D3DDDIARG_GETCAPS. Digitare e a volte nel membro pInfo .

Nella tabella seguente sono riportati due esempi di come configurare la chiamata PFND3DDDI_GETCAPS a seconda del valore di D3DDDIARG_GETCAPS. Tipo.

D3DDDIARG_GETCAPS membro Esempio 1 Esempio 2
Tipo D3DDDICAPS_DDRAW D3DDDICAPS_GETFORMATCOUNT
pInfo [in] NULL (nessuna condizione è impostata) [in] NULL (nessuna condizione è impostata)
pData [out] DDRAW_CAPS (puntatore univoco) [out] UINT* (puntatore univoco)
DataSize sizeof(DDRAW_CAPS) sizeof(UINT)
Note Il driver deve compilare la struttura DDRAW_CAPS con le funzionalità DirectDraw supportate. Il driver deve riempire il buffer a cui fa riferimento pData con un valore UINT che rappresenta il numero di formati di superficie D3DDDIFORMAT supportati dal dispositivo.

Vedere D3DDDIARG_GETCAPS per spiegazioni di altri valori per D3DDDIARG_GETCAPS. Tipo usato per le sovrapposizioni multiplane.

Simple_instancing

Se un driver Direct3D Level 9 che supporta Windows Display Driver Model (WDDM) 1.3 e versioni successive completa una chiamata a PFND3DDDI_GETCAPS e restituisce S_OK ma non modifica i dati nella struttura D3DDDIARG_GETCAPS , indica al runtime Direct3D che l'hardware e il driver non supportano semplici instancing. Per altre informazioni, vedere D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Piattaforma di destinazione Desktop
Intestazione d3dumddi.h (include D3dumddi.h)

Vedi anche

D3DDDIARG_GETCAPS

D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT

D3DDDIFORMAT

D3DDDI_ADAPTERFUNCS

DDRAW_CAPS