DirectDrawCreateClipper-Funktion (ddraw.h)

Erstellt eine instance eines DirectDrawClipper-Objekts, das keinem DirectDraw-Objekt zugeordnet ist.

Syntax

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

Parameter

[in] dwFlags

Derzeit nicht verwendet und muss auf 0 festgelegt werden.

[out] lplpDDClipper

Adresse eines Zeigers, der mit der Adresse des neuen DirectDrawClipper-Objekts gefüllt werden soll.

[in] pUnkOuter

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

Rückgabewert

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

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

• DDERR_INVALIDPARAMS
• DDERR_OUTOFMEMORY

Hinweise

Sie können DirectDrawCreateClipper aufrufen, bevor DirectDraw-Objekte erstellt werden. Da diese DirectDrawClipper-Objekte keinem DirectDraw-Objekt gehören, werden sie nicht automatisch freigegeben, wenn die Objekte einer Anwendung freigegeben werden. Wenn die Anwendung die DirectDrawClipper-Objekte nicht explizit freigibt, gibt DirectDraw sie beim Beenden der Anwendung frei.

Verwenden Sie zum Erstellen eines DirectDrawClipper-Objekts, das sich im Besitz eines bestimmten DirectDraw-Objekts befindet, die IDirectDraw7::CreateClipper-Methode .

Sie müssen LoadLibrary verwenden, um explizit mit Ddraw.dll zu verknüpfen, und dann GetProcAddress verwenden, um auf die DirectDrawCreateClipper-Funktion zuzugreifen.

Anforderungen