structure DD_NTPRIVATEDRIVERCAPS (ddrawint.h)

La structure DD_NTPRIVATEDRIVERCAPS permet au pilote de modifier le comportement de Microsoft DirectDraw lorsque DirectDraw crée des surfaces.

Syntaxe

typedef struct DD_NTPRIVATEDRIVERCAPS {
  DWORD dwSize;
  DWORD dwPrivateCaps;
} DD_NTPRIVATEDRIVERCAPS;

Membres

dwSize

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

dwPrivateCaps

Indique comment DirectDraw doit créer la surface.

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

Lorsque cet indicateur est défini, il indique que le pilote demande que DdCreateSurface soit appelé une seule fois lorsque l’application crée une chaîne de basculement complexe à l’aide d’un seul appel CreateSurface . Dans ce cas, le membre lplpSList de la structure DD_CREATESURFACEDATA pointe vers une liste de surfaces à créer (plutôt qu’une seule surface) et dwSCnt contient le nombre de surfaces dans la liste.

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

Lorsque cet indicateur est défini, la fonction DdCreateSurface du pilote est appelée lors de la création d’une surface primaire. Si cet indicateur n’est pas défini, la fonction DdCreateSurface du pilote n’est pas appelée.

Remarques

Le comportement de DirectDraw émule les techniques de création de surface utilisées par DirectDraw lors de la création de surfaces pour Microsoft Windows 98/Me.

Lorsque l’indicateur DDHAL_PRIVATECAP_AUTOMICSURFACECREATION n’est pas défini, DirectDraw crée une surface à l’aide de la méthode d’origine, c’est-à-dire qu’il appelle la fonction DdCreateSurface du pilote une fois pour chaque surface créée.

Lorsque l’indicateur DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION n’est pas défini, DirectDraw effectue la création d’une surface principale à l’aide de la méthode d’origine, c’est-à-dire qu’il n’appelle pas le pilote lors de la création d’une surface primaire.

Configuration requise

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

Voir aussi

DD_CREATESURFACEDATA

DdCreateSurface