DD_MISCELLANEOUS2CALLBACKS-Struktur (ddrawint.h)

Artikel
02/29/2024

Die DD_MISCELLANEOUS2CALLBACKS-Struktur wird verwendet, um die Adressen verschiedener Rückrufroutinen zurückzugeben. Diese Routinen sind neu für Microsoft DirectX 7.0 und höher und werden über DdGetDriverInfo verfügbar gemacht, indem sie auf die GUID_Miscellaneous2Callbacks GUID reagieren.

Syntax

typedef struct _DD_MISCELLANEOUS2CALLBACKS {
  DWORD               dwSize;
  DWORD               dwFlags;
  PDD_ALPHABLT        AlphaBlt;
  PDD_CREATESURFACEEX CreateSurfaceEx;
  PDD_GETDRIVERSTATE  GetDriverState;
  PDD_DESTROYDDLOCAL  DestroyDDLocal;
} DD_MISCELLANEOUS2CALLBACKS, *PDD_MISCELLANEOUS2CALLBACKS;

Member

dwSize

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

dwFlags

Gibt an, welche verschiedenen Rückruffunktionen der Treiber implementiert hat. Für jedes in dwFlags festgelegte Bit muss der Treiber den entsprechenden Funktionszeigermember dieser Struktur initialisieren. Bei diesem Member kann es sich um ein oder mehrere der folgenden Flags handelt:

DDHAL_MISC2CB32_CREATESURFACEEX
DDHAL_MISC2CB32_GETDRIVERSTATE
DDHAL_MISC2CB32_DESTROYDDLOCAL

AlphaBlt

Nicht verwendet und muss auf NULL festgelegt werden.

CreateSurfaceEx

Verweist auf die D3dCreateSurfaceEx-Implementierung des Treibers. Dieser Rückruf erstellt eine Zuordnung zwischen einer DirectDraw-Oberfläche und einem kleinen ganzzahligen Handle.

GetDriverState

Verweist auf die D3dGetDriverState-Implementierung des Treibers.

DestroyDDLocal

Verweist auf die D3dDestroyDLocal-Implementierung des Treibers. Wird verwendet, um die lokale Kopie des Gerätekontexts zu zerstören.