Partager via


DD_GETDRIVERINFODATA structure (ddrawint.h)

La structure DD_GETDRIVERINFODATA est utilisée pour passer des données vers et à partir de la routine de rappel DdGetDriverInfo .

Syntaxe

typedef struct _DD_GETDRIVERINFODATA {
  VOID    *dhpdev;
  DWORD   dwSize;
  DWORD   dwFlags;
  GUID    guidInfo;
  DWORD   dwExpectedSize;
  PVOID   lpvData;
  DWORD   dwActualSize;
  HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;

Membres

dhpdev

Gérez le PDEV du pilote. Microsoft Windows 2000 et versions ultérieures uniquement.

dwSize

Spécifie la taille en octets de cette structure DD_GETDRIVERINFODATA.

dwFlags

Actuellement inutilisé et est défini sur zéro.

guidInfo

Spécifie le GUID de la prise en charge de Microsoft DirectX pour laquelle le pilote est interrogé. Dans un pilote Microsoft DirectDraw windows 2000 et ultérieur, ce membre peut être l’une des valeurs suivantes (dans l’ordre alphabétique) :

GUID Description
GUID_ColorControlCallbacks Demande si le pilote prend en charge DdControlColor. Si le pilote le prend en charge, il doit initialiser et retourner une structure DD_COLORCONTROLCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_D3DCallbacks Demande si le pilote prend en charge l’une des fonctionnalités spécifiées par le biais de la structure D3DHAL_CALLBACKS . Si le pilote ne fournit aucune de cette prise en charge, il doit initialiser et retourner une structure D3DHAL_CALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_D3DCallbacks2 Obsolète.
GUID_D3DCallbacks3 Demande si le pilote prend en charge l’une des fonctionnalités spécifiées par le biais de la structure D3DHAL_CALLBACKS3 . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure D3DHAL_CALLBACKS3 dans la mémoire tampon vers laquelle lpvData pointe.
GUID_D3DCaps Obsolète.
GUID_D3DExtendedCaps Demande si le pilote prend en charge l’une des fonctionnalités de Microsoft Direct3D spécifiées par le biais de la structure de D3DHAL_D3DEXTENDEDCAPS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure D3DHAL_D3DEXTENDEDCAPS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_D3DParseUnknownCommandCallback Fournit à la partie Direct3D du pilote le D3dParseUnknownCommandCallback du runtime Direct3D. Le rappel D3dDrawPrimitives2 du pilote appelle D3dParseUnknownCommandCallback pour analyser les commandes de la mémoire tampon de commandes que le pilote ne comprend pas. DirectDraw passe un pointeur vers cette fonction dans la mémoire tampon vers laquelle lpvData pointe. Si le pilote prend en charge cet aspect de Direct3D, il doit stocker le pointeur.
GUID_GetHeapAlignment Demande si le pilote prend en charge les exigences d’alignement de surface par segment. Si le pilote fournit cette prise en charge, il doit initialiser et retourner une structure DD_GETHEAPALIGNMENTDATA dans la mémoire tampon vers laquelle lpvData pointe.
GUID_KernelCallbacks Demande si le pilote prend en charge l’une des fonctionnalités spécifiées via la structure DD_KERNELCALLBACKS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DD_KERNELCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_KernelCaps Demande si le pilote prend en charge l’une des fonctionnalités en mode noyau spécifiées par le biais de la structure DDKERNELCAPS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DDKERNELCAPS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_MiscellaneousCallbacks Demande si le pilote prend en charge DdGetAvailDriverMemory. Si le pilote le prend en charge, il doit initialiser et retourner une structure DD_MISCELLANEOUSCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_Miscellaneous2Callbacks Demande si le pilote prend en charge les fonctionnalités diverses supplémentaires spécifiées dans la structure DD_MISCELLANEOUS2CALLBACKS . Si le pilote prend en charge l’une de ces prises en charge, le pilote doit initialiser et retourner une structure DD_MISCELLANEOUS2CALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_MotionCompCallbacks Demande si le pilote prend en charge la fonctionnalité de compensation de mouvement spécifiée par le biais de la structure DD_MOTIONCOMPCALLBACKS . Si le pilote fournit l’une de ces prises en charge, est doit initialiser et retourner une structure DD_MOTIONCOMPCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_NonLocalVidMemCaps Demande si le pilote prend en charge l’une des fonctionnalités de mémoire d’affichage non locales spécifiées par le biais de la structure DD_NONLOCALVIDMEMCAPS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DD_NONLOCALVIDMEMCAPS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_NTCallbacks Demande si le pilote prend en charge l’une des fonctionnalités spécifiées par le biais de la structure DD_NTCALLBACKS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DD_NTCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_NTPrivateDriverCaps Demande si le pilote prend en charge les techniques de création de surface de style Windows 98/Me spécifiées par le biais de la structure DD_NTPRIVATEDRIVERCAPS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DD_NTPRIVATEDRIVERCAPS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_UpdateNonLocalHeap Demande si le pilote prend en charge la récupération des adresses de base de chaque tas non local à son tour. Si le pilote fournit cette prise en charge, il doit initialiser et retourner une structure DD_UPDATENONLOCALHEAPDATA dans la mémoire tampon vers laquelle lpvData pointe.
GUID_VideoPortCallbacks Demande si le pilote prend en charge les extensions de port vidéo (VPE). Si le pilote prend en charge VPE, il doit initialiser et retourner une structure DD_VIDEOPORTCALLBACKS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_VideoPortCaps Demande si le pilote prend en charge l’une des fonctionnalités d’objet VPE spécifiées via la structure DDVIDEOPORTCAPS . Si le pilote fournit l’une de ces prises en charge, il doit initialiser et retourner une structure DDVIDEOPORTCAPS dans la mémoire tampon vers laquelle lpvData pointe.
GUID_ZPixelFormats Interroge les formats de pixels pris en charge par la mémoire tampon de profondeur. Si le pilote prend en charge Direct3D, il doit allouer et initialiser les membres appropriés d’une structure DDPIXELFORMAT pour chaque format z-buffer qu’il prend en charge et les retourner dans la mémoire tampon vers laquelle lpvData pointe.

dwExpectedSize

Spécifie le nombre d’octets de données que DirectDraw s’attend à ce que le pilote retranscèle dans la mémoire tampon vers laquelle lpvData pointe.

lpvData

Pointe vers une mémoire tampon allouée par DirectDraw dans laquelle le pilote copie les données demandées. Cette mémoire tampon est généralement de taille dwExpectedSize octets. Le pilote ne doit pas écrire plus de dwExpectedSize octets de données. Le pilote spécifie le nombre d’octets qu’il écrit dans cette mémoire tampon dans le membre dwActualSize .

dwActualSize

Spécifie l’emplacement dans lequel le pilote retourne le nombre d’octets de données qu’il écrit dans lpvData.

ddRVal

Spécifie l’emplacement dans lequel le pilote écrit la valeur de retour du rappel DdGetDriverInfo . Un code de retour de DD_OK indique la réussite. Pour plus d’informations, consultez Valeurs de retour pour DirectDraw.

Remarques

La structure de données transmise au pilote pour un appel DdGetDriverInfo présente des différences mineures entre Windows 98/Me et Windows 2000 et versions ultérieures. Sur Windows 2000 et versions ultérieures, la structure de données est appelée DD_GETDRIVERINFODATA et sur Windows 98/Me, la structure de données est appelée DDHAL_GETDRIVERINFODATA. Les deux structures de données incluent un champ pour les informations de contexte spécifiques au pilote. Sur Windows 2000 et versions ultérieures, DD_GETDRIVERINFODATA inclut un dhpdev de champ qui stocke le DHPDEV du pilote appelé. Uniquement sur Windows 98/Me, DDHAL_GETDRIVERINFODATA inclut un champ dwContext copié pour le champ dwReserved3 réservé au pilote de l’objet global DirectDraw.

Configuration requise

Condition requise Valeur
En-tête ddrawint.h (incluez Winddi.h)

Voir aussi

DdGetDriverInfo