Fonction NtGdiD3DDrawPrimitives2

Article
06/13/2023

[Cette fonction est susceptible d’être modifiée à chaque révision du système d’exploitation. Utilisez plutôt Microsoft DirectDraw et Microsoft Direct3DAPIs ; ces API isolent les applications de tels changements de système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]

Affiche les primitives et retourne l’état de rendu mis à jour.

Syntaxe

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

Paramètres

hCmdBuf [in]: Gérez la structure DD_SURFACE_LOCAL qui identifie la surface DirectDraw contenant les données de commande.
hVBuf [in]: Gérez la structure DD_SURFACE_LOCAL qui identifie la surface DirectDraw contenant les données de vertex.
pded [in, out]: Pointeur vers une structure D3DNTHAL_DRAWPRIMITIVES2DATA qui contient les informations requises pour que le pilote affiche une ou plusieurs primitives.
pfpVidMemCmd [in, out]: Nouveau pointeur vers la mémoire vidéo si le pilote a échangé la mémoire tampon de commande.
pdwSizeCmd [in, out]: Spécifie le nombre minimal d’octets dont le pilote doit augmenter la mémoire tampon de commande d’échange.
pfpVidMemVtx [in, out]: Nouveau pointeur vers la mémoire vidéo si le pilote a échangé la mémoire tampon de vertex.
pdwSizeVtx [in, out]: Spécifie le nombre minimal d’octets que le pilote doit allouer pour la mémoire tampon de vertex d’échange.

Valeur retournée

NtGdiD3DDrawPrimitives2 retourne l’un des codes de rappel suivants.

Code de retour	Description
DDHAL_DRIVER_HANDLED	Le pilote a effectué l’opération et retourné un code de retour valide pour cette opération. Si ce code est DD_OK, DirectDraw ou Direct3D poursuit avec la fonction . Sinon, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction.
DDHAL_DRIVER_NOTHANDLED	Le pilote n’a aucun 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. Sinon, DirectDraw ou Direct3D gère l’opération comme si le rappel du pilote n’avait pas été défini en exécutant l’implémentation indépendante de l’appareil DirectDraw ou Direct3D.

Spécifications

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	Ntgdi.h

Voir aussi

Prise en charge du client graphique de bas niveau

Partager via