NtGdiD3DContextCreate fonction)
[Cette fonction est sujette à modification avec chaque révision du système d’exploitation. Utilisez plutôt Microsoft DirectDraw et Microsoft Direct3DAPIs ; Ces API isolent les applications de ces modifications du système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]
Crée un contexte.
Syntaxe
BOOL APIENTRY NtGdiD3DContextCreate(
_In_ HANDLE hDirectDrawLocal,
_In_ HANDLE hSurfColor,
_In_ HANDLE hSurfZ,
_Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);
Paramètres
-
hDirectDrawLocal [ dans]
-
Handle vers un objet DirectDraw en mode noyau, créé précédemment avec NtGdiDdCreateDirectDrawObject, représentant l’appareil sur lequel le contexte Direct3D doit être créé.
-
hSurfColor [ dans]
-
Handle vers une structure de _ surface _ locale DD qui décrit la surface DirectDraw à utiliser comme cible de rendu.
-
hSurfZ [ dans]
-
Handle vers une structure de _ surface _ locale DD qui décrit la surface DirectDraw à utiliser comme mémoire tampon de profondeur. Si ce membre a la valeur null, aucune mise en mémoire tampon de profondeur ne doit être effectuée.
-
pdcci [ in, out]
-
Pointeur vers une structure D3DNTHAL _ CONTEXTCREATEDATA qui contient les informations requises pour créer un contexte et les données que le pilote doit stocker dans le nouveau contexte.
Valeur retournée
NtGdiD3DContextCreate retourne l’un des codes de rappel suivants.
| Code de retour | Description |
|---|---|
|
Le pilote a effectué l’opération et a retourné un code de retour valide pour cette opération. Si ce code est JJ _ OK, DirectDraw ou Direct3D continue avec la fonction. Dans le cas contraire, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction. |
|
Le pilote n’a pas de commentaire sur l’opération demandée. Si le pilote doit avoir implémenté un rappel particulier, DirectDraw ou Direct3D signale une condition d’erreur. Dans le cas contraire, DirectDraw ou Direct3D gère l’opération comme si le rappel de pilote n’avait pas été défini par l’exécution de l’implémentation de DirectDraw ou de l’implémentation indépendante du périphérique Direct3D. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel - [Applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
| En-tête |
|