DDHAL_WAITFORVERTICALBLANKDATA-Struktur (ddrawi.h)

Die DD_WAITFORVERTICALBLANKDATA-Struktur enthält Informationen, die zum Abrufen der vertikalen leeren Informationen des Monitors erforderlich sind.

Syntax

typedef struct _DDHAL_WAITFORVERTICALBLANKDATA {
  LPDDRAWI_DIRECTDRAW_GBL      lpDD;
  DWORD                        dwFlags;
  DWORD                        bIsInVB;
  ULONG_PTR                    hEvent;
  HRESULT                      ddRVal;
  LPDDHAL_WAITFORVERTICALBLANK WaitForVerticalBlank;
} *LPDDHAL_WAITFORVERTICALBLANKDATA, DDHAL_WAITFORVERTICALBLANKDATA;

Member

lpDD

Verweist auf eine DD_DIRECTDRAW_GLOBAL Struktur, die das Gerät des Treibers beschreibt.

dwFlags

Gibt an, wie der Treiber auf den vertikalen Leerzeichen warten soll. Dieser Member kann einer der folgenden Werte sein:

Flag	Bedeutung
DDWAITVB_BLOCKBEGIN	Der Treiber sollte zurückgegeben werden, wenn er den Anfang des vertikalen leeren Intervalls erkennt.
DDWAITVB_BLOCKBEGINEVENT	Richten Sie ein Ereignis ein, das ausgelöst wird, wenn das vertikale Leerzeichen beginnt. Dieses Flag wird derzeit nicht unterstützt.
DDWAITVB_BLOCKEND	Der Treiber sollte zurückgeben, wenn er das Ende des vertikalen leeren Intervalls erkennt und die Anzeige beginnt.
DDWAITVB_I_TESTVB	Der Treiber sollte ermitteln, ob derzeit ein vertikales Leerzeichen auftritt, und die status in bIsInVB zurückgeben.

bIsInVB

Gibt die status der vertikalen Leerzeichen an. Der Wert TRUE gibt an, dass sich das Gerät in einem vertikalen Leerzeichen befindet. FALSE bedeutet, dass dies nicht der Wert ist. Der Treiber sollte die aktuelle vertikale Leerung status in diesem Member zurückgeben, wenn dwFlags DDWAITVB_I_TESTVB ist.

hEvent

Handle für das Ereignis, das ausgelöst werden soll, wenn das vertikale Leerzeichen beginnt. Das Ereignis wird bei einem Interrupt ausgelöst. Wenn Ihre Hardware also einen Interrupt für den vertikalen Leerlauf generieren kann, sollten Sie dieses Ereignishandle an Ihre HwVidInterrupt-Funktion übergeben, damit das Ereignis ausgelöst wird, wenn der Interrupt ausgelöst wird. Dieser Member wird derzeit nicht unterstützt und sollte vom Treiber ignoriert werden.

ddRVal

Gibt den Speicherort an, an dem der Treiber den Rückgabewert des DdWaitForVerticalBlank-Rückrufs schreibt. Ein Rückgabecode von DD_OK gibt den Erfolg an. Weitere Informationen finden Sie unter Rückgabewerte für DirectDraw.

WaitForVerticalBlank

Wird von der Microsoft DirectDraw-API verwendet und sollte nicht vom Treiber ausgefüllt werden.

Anforderungen

Anforderung	Wert
Header	ddrawi.h (einschließlich Winddi.h, Ddrawi.h)

Weitere Informationen

DdWaitForVerticalBlank