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.
PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;
HRESULT Pfnd3dddiGetcaps(
HANDLE hAdapter,
const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}
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.
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. |
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.
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.
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |