PFND3DDDI_GETCAPS fonction de rappel (d3dumddi.h)

Article
02/26/2024

Le runtime D3D appelle la fonction de rappel PFND3DDDI_GETCAPS du pilote pour interroger les fonctionnalités de la carte graphique.

Syntaxe

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

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

Paramètres

hAdapter

Handle qui identifie la carte graphique.

unnamedParam2

pData [in, out]

Pointeur vers une structure de D3DDDIARG_GETCAPS qui décrit les fonctionnalités à récupérer.

Valeur retournée

PFND3DDDI_GETCAPS retourne l’une des valeurs suivantes :

Code de retour	Description
S_OK	Les fonctionnalités ont été récupérées avec succès.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS n’a pas pu allouer la mémoire requise pour qu’elle se termine.

Remarques

Les données retournées dans le membre pData de la structure D3DDDIARG_GETCAPS dépendent du type de données demandé (autrement dit, les données dépendent de D3DDDIARG_GETCAPS. Tapez et parfois sur le membre pInfo ).

Le tableau suivant présente deux exemples de configuration de l’appel PFND3DDDI_GETCAPS en fonction de la valeur de D3DDDIARG_GETCAPS. Tapez.

D3DDDIARG_GETCAPS membre	Exemple 1	Exemple 2
Type	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL (aucune condition n’est définie)	[in] NULL (aucune condition n’est définie)
Pdata	[out] DDRAW_CAPS (pointeur unique)	[out] UINT* (pointeur unique)
DataSize	sizeof(DDRAW_CAPS)	sizeof(UINT)
Notes	Le pilote doit remplir la structure DDRAW_CAPS avec les fonctionnalités DirectDraw qu’il prend en charge.	Le pilote doit remplir la mémoire tampon pointée par pData avec une valeur UINT qui représente le nombre de formats de surface D3DDDIFORMAT pris en charge par l’appareil.

Consultez D3DDDIARG_GETCAPS pour obtenir des explications sur d’autres valeurs pour D3DDDIARG_GETCAPS. Type utilisé pour les superpositions multiplanes.

Simple_instancing

Si un pilote Direct3D level 9 qui prend en charge windows Display Driver Model (WDDM) 1.3 et versions ultérieures termine un appel à PFND3DDDI_GETCAPS et retourne S_OK mais ne modifie pas les données dans la structure D3DDDIARG_GETCAPS , cela indique au runtime Direct3D que le matériel et le pilote ne prennent pas en charge l’instanciation simple. Pour plus d’informations, consultez D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.