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) |