DD_NTPRIVATEDRIVERCAPS-Struktur (ddrawint.h)

Die DD_NTPRIVATEDRIVERCAPS-Struktur ermöglicht es dem Treiber, das Verhalten von Microsoft DirectDraw zu ändern, wenn DirectDraw Oberflächen erstellt.

Syntax

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

Member

dwSize

Gibt die Größe dieser DD_NTPRIVATEDRIVERCAPS-Struktur in Bytes an.

dwPrivateCaps

Gibt an, wie DirectDraw die Oberfläche erstellen soll.

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

Wenn dieses Flag festgelegt ist, gibt es an, dass der Treiber DdCreateSurface nur einmal aufruft, wenn die Anwendung mithilfe eines einzelnen CreateSurface-Aufrufs eine komplexe Flipping-Kette erstellt. In diesem Fall verweist das lplpSList-Element der DD_CREATESURFACEDATA-Struktur auf eine Liste von zu erstellenden Oberflächen (anstelle einer einzelnen Oberfläche), und dwSCnt enthält die Anzahl der Oberflächen in der Liste.

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

Wenn dieses Flag festgelegt ist, wird die DdCreateSurface-Funktion des Treibers aufgerufen, wenn eine primäre Oberfläche erstellt wird. Wenn dieses Flag nicht festgelegt ist, wird die DdCreateSurface-Funktion des Treibers nicht aufgerufen.

Hinweise

Das Verhalten von DirectDraw emuliert die Von DirectDraw beim Erstellen von Oberflächen für Microsoft Windows 98/Me verwendeten Oberflächenerstellungstechniken.

Wenn das DDHAL_PRIVATECAP_AUTOMICSURFACECREATION-Flag nicht festgelegt ist, führt DirectDraw die Oberflächenerstellung mit der ursprünglichen Methode durch, d. h. die DdCreateSurface-Funktion des Treibers wird einmal für jede zu erstellende Oberfläche aufgerufen.

Wenn das flag DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION nicht festgelegt ist, führt DirectDraw die Erstellung der primären Oberfläche mithilfe der ursprünglichen Methode durch, d. h. beim Erstellen einer primären Oberfläche wird der Treiber nicht aufgerufen.

Anforderungen

Weitere Informationen

DD_CREATESURFACEDATA

DdCreateSurface