IDirectDraw7::CreateClipper-Methode (ddraw.h)

Erstellt ein DirectDrawClipper -Objekt.

Syntax

HRESULT CreateClipper(
  [in]  DWORD               unnamedParam1,
  [out] LPDIRECTDRAWCLIPPER *unnamedParam2,
  [in]  IUnknown            *unnamedParam3
);

Parameter

[in] unnamedParam1

Derzeit nicht verwendet und muss auf 0 festgelegt werden.

[out] unnamedParam2

Adresse einer Variablen, die auf einen gültigen IDirectDrawClipper Schnittstellenzeiger festgelegt werden soll, wenn der Aufruf erfolgreich ist.

[in] unnamedParam3

Ermöglicht zukünftige Kompatibilität mit COM-Aggregationsfeatures. Derzeit gibt diese Methode einen Fehler zurück, wenn dieser Parameter nicht NULL ist.

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_NOCOOPERATIVELEVELSET
• DDERR_OUTOFMEMORY

Bemerkungen

Das DirectDrawClipper-Objekt kann an eine DirectDrawSurface angefügt und während IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatchund IDirectDrawSurface7::UpdateOverlay Vorgänge verwendet werden.

Verwenden Sie zum Erstellen eines DirectDrawClipper-Objekts, das nicht einem bestimmten DirectDraw-Objekt gehört, die DirectDrawCreateClipper--Funktion.

Anforderungen

Siehe auch

IDirectDraw7-