PFND3DDDI_GETCAPS funzione di callback (d3dumddi.h)

Articolo
03/08/2023

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.