Fonction DrvGetDirectDrawInfo (winddi.h)

Article
08/27/2023

La fonction DrvGetDirectDrawInfo retourne les fonctionnalités du matériel graphique.

Syntaxe

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

Paramètres

dhpdev

Gérez le PDEV retourné par la routine DrvEnablePDEV du pilote.

pHalInfo

Pointe vers une structure DD_HALINFO dans laquelle le pilote doit retourner les fonctionnalités matérielles qu’il prend en charge.

pdwNumHeaps

Pointe vers l’emplacement dans lequel le pilote doit retourner le nombre de structures VIDEOMEMORY pointées vers pvmList.

pvmList

Pointe vers un tableau de structures VIDEOMEMORY dans lequel le pilote doit retourner des informations sur chaque segment de mémoire d’affichage qu’il contrôle. Le pilote doit ignorer ce paramètre lorsqu’il est NULL.

pdwNumFourCCCodes

Pointe vers l’emplacement dans lequel le pilote doit retourner le nombre de DWORD pointés par pdwFourCC.

pdwFourCC

Pointe vers un tableau de DWORD dans lequel le pilote doit retourner des informations sur chaque FOURCC qu’il prend en charge. Le pilote doit ignorer ce paramètre lorsqu’il est NULL.

Valeur retournée

DrvGetDirectDrawInfo retourne TRUE s’il réussit ; sinon, il retourne FALSE.

Remarques

La routine DrvGetDirectDrawInfo du pilote doit effectuer les opérations suivantes :

Lorsque pvmList et pdwFourCC ont la valeur NULL :
1. Réservez la mémoire d’affichage hors écran pour l’utilisation de DirectDraw.
2. Écrivez le nombre de tas de mémoire d’affichage du pilote et les FOURC pris en charge dans pdwNumHeaps et pdwNumFourCC, respectivement.
Lorsque pvmList et pdwFourCC ne sont pas NULL :
1. Écrivez le nombre de tas de mémoire d’affichage du pilote et les FOURC pris en charge dans pdwNumHeaps et pdwNumFourCC, respectivement.
2. Pour chaque structure VIDEOMEMORY de la liste vers laquelle pvmList pointe, renseignez les membres appropriés pour décrire un segment particulier de mémoire d’affichage. La liste des structures fournit à DirectDraw une description complète de la mémoire hors écran du pilote.
Initialisez les membres de la structure DD_HALINFO avec des informations spécifiques au pilote comme suit :
1. Initialisez les membres appropriés de la structure VIDEOMEMORYINFO dans vmiData pour décrire les caractéristiques générales de la mémoire de l’affichage.
2. Initialisez les membres appropriés de la structure DDCORECAPS dans ddCaps pour décrire les fonctionnalités du matériel.
3. Si le pilote implémente une fonction DdGetDriverInfo , définissez GetDriverInfo pour qu’il pointe vers celle-ci et définissez dwFlags sur DDHALINFO_GETDRIVERINFOSET.