struttura DD_NTPRIVATEDRIVERCAPS (ddrawint.h)

  • Articolo

La struttura DD_NTPRIVATEDRIVERCAPS consente al driver di modificare il comportamento di Microsoft DirectDraw quando DirectDraw crea superfici.

Sintassi

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

Members

dwSize

Specifica le dimensioni in byte della struttura DD_NTPRIVATEDRIVERCAPS.

dwPrivateCaps

Indica come DirectDraw deve creare la superficie.

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

Quando questo flag è impostato, indica che il driver richiede che DdCreateSurface venga chiamato una sola volta quando l'applicazione crea una catena di capovolgimento complessa usando una singola chiamata CreateSurface . In questo caso, il membro lplpSList della struttura DD_CREATESURFACEDATA punta a un elenco di superfici da creare (anziché una singola superficie) e dwSCnt contiene il numero di superfici nell'elenco.

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

Quando questo flag viene impostato, la funzione DdCreateSurface del driver viene chiamata durante la creazione di una superficie primaria. Se questo flag non è impostato, la funzione DdCreateSurface del driver non viene chiamata.

Commenti

Il comportamento di DirectDraw emula le tecniche di creazione della superficie usate da DirectDraw durante la creazione di superfici per Microsoft Windows 98/Me.

Quando il flag DDHAL_PRIVATECAP_AUTOMICSURFACECREATION non è impostato, DirectDraw esegue la creazione della superficie usando il metodo originale, ovvero chiama la funzione DdCreateSurface del driver una volta per ogni superficie creata.

Quando il flag DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION non è impostato, DirectDraw esegue la creazione della superficie primaria usando il metodo originale, ovvero non chiama il driver durante la creazione di una superficie primaria.

Requisiti

Requisito Valore
Intestazione ddrawint.h (include Winddi.h)

Vedi anche

DD_CREATESURFACEDATA

DdCreateSurface