PFND3DDDI_GETCAPS fonction de rappel (d3dumddi.h)
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |