IDirectDrawSurface7::GetColorKey-Methode (ddraw.h)

Ruft den Farbschlüsselwert für diese Oberfläche ab.

Syntax

HRESULT GetColorKey(
  [in]  DWORD        unnamedParam1,
  [out] LPDDCOLORKEY unnamedParam2
);

Parameter

[in] unnamedParam1

Ein Wert, der auf eines der folgenden Flags festgelegt werden kann, um den abzurufenden Farbschlüssel anzugeben:

DDCKEY_DESTBLT

Ein Farbschlüssel oder Farbraum, der als Zielfarbschlüssel für Bitblockübertragungsvorgänge (Bitblt) verwendet werden soll.

DDCKEY_DESTOVERLAY

Eine Farbtaste oder ein Farbraum, der als Zielfarbschlüssel für Überlagerungsvorgänge verwendet werden soll.

DDCKEY_SRCBLT

Ein Farbschlüssel oder Farbraum, der als Quellfarbschlüssel für Bitblt-Vorgänge verwendet werden soll.

DDCKEY_SRCOVERLAY

Eine Farbtaste oder ein Farbraum, der als Quellfarbschlüssel für Überlagerungsvorgänge verwendet werden soll.

[out] unnamedParam2

Ein Zeiger auf eine DDCOLORKEY-Struktur , die die aktuellen Werte für den angegebenen Farbschlüssel des DirectDrawSurface-Objekts empfängt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.

Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOCOLORKEY
• DDERR_NOCOLORKEYHW
• DDERR_SURFACELOST
• DDERR_UNSUPPORTED

Anforderungen

Weitere Informationen

IDirectDrawSurface7