PFND3DDDI_GETCAPS fonction de rappel (d3dumddi.h)

Article
02/06/2025

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 l’adaptateur graphique.

unnamedParam2

pData [in, out]

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

Valeur de retour

PFND3DDDI_GETCAPS retourne l’une des valeurs suivantes :

Retourner le code	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 nécessaire 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 contient deux exemples de configuration de l’appel PFND3DDDI_GETCAPS en fonction de la valeur de D3DDDIARG_GETCAPS. Tapez.

membre D3DDDIARG_GETCAPS	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és pour les superpositions multiplanes.

Simple_instancing

Si un pilote Direct3D Level 9 qui prend en charge le modèle de pilote d’affichage Windows (WDDM) 1.3 et les versions ultérieures effectue un appel à PFND3DDDI_GETCAPS et retourne S_OK mais ne modifie pas les données de la structure D3DDDIARG_GETCAPS, il 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.