D3DDDI_OVERLAYINFO-Struktur (d3dumddi.h)

Die D3DDDI_OVERLAYINFO-Struktur beschreibt Informationen zu einer Überlagerung.

Syntax

typedef struct _D3DDDI_OVERLAYINFO {
  [in] HANDLE                  hResource;
  [in] UINT                    SubResourceIndex;
  [in] RECT                    DstRect;
  [in] RECT                    SrcRect;
  [in] UINT                    DstColorKeyLow;
  [in] UINT                    DstColorKeyHigh;
  [in] UINT                    SrcColorKeyLow;
  [in] UINT                    SrcColorKeyHigh;
  [in] D3DDDI_OVERLAYINFOFLAGS Flags;
} D3DDDI_OVERLAYINFO;

Member

[in] hResource

Ein Handle für die Ressource, das mithilfe der Überlagerung angezeigt wird. Die Ressource wird durch einen Aufruf der CreateResource-Funktion erstellt, wobei das Bitfeldflag Overlay im Flags-Element der D3DDDIARG_CREATERESOURCE-Struktur festgelegt ist, auf die der pResource-Parameter verweist.

[in] SubResourceIndex

Der Index für die Unterressource, wenn die vom hResource-Element angegebene Ressource eine Liste von Zuordnungen enthält.

[in] DstRect

Eine RECT-Struktur für das Zielrechteck, das die Ausgabekoordinaten für die Anzeige enthält.

[in] SrcRect

Eine RECT-Struktur für das angezeigte Quellrechteck.

[in] DstColorKeyLow

Ein Wert für den Zielfarbschlüssel, wenn das DstColorKey-Bitfeldflag im Flags-Element festgelegt ist. Wenn der Farbschlüssel ein Bereich ist, enthält DstColorKeyLow das untere Ende des Bereichs. Der Wert befindet sich im nativen Format der primären Oberfläche, die überlagert ist.

[in] DstColorKeyHigh

Das obere Ende des Zielfarbschlüsselbereichs, wenn das DstColorKeyRange-Bitfeldflag in Flags festgelegt ist. Der Wert befindet sich im nativen Format der primären Oberfläche, die überlagert ist.

[in] SrcColorKeyLow

Ein Wert für den Quellfarbschlüssel, wenn das SrcColorKey-Bitfeldflag im Flags-Element festgelegt ist. Wenn der Farbschlüssel ein Bereich ist, enthält SrcColorKeyLow das untere Ende des Bereichs. Der Wert befindet sich im nativen Format der angezeigten Überlagerungsressource.

[in] SrcColorKeyHigh

Das obere Ende des Quellfarbschlüsselbereichs, wenn das SrcColorKeyRange-Bitfeldflag in Flags festgelegt ist. Der Wert befindet sich im nativen Format der angezeigten Überlagerungsressource.

[in] Flags

Eine D3DDDI_OVERLAYINFOFLAGS Struktur, die den Typ des auszuführenden Überlagerungsvorgangs angibt. Beachten Sie, dass sich einige Flags mit anderen Flags gegenseitig ausschließen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Die Bitfeldflags SrcColorKey, SrcColorKeyRange, DstColorKey und DstColorKeyRange werden nie gleichzeitig im Flags-Element festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

CreateOverlay

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OVERLAYINFOFLAGS

RECT

UpdateOverlay