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
Hinweise
Das DirectDrawClipper-Objekt kann an ein DirectDrawSurface angefügt und während der Vorgänge IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch und IDirectDrawSurface7::UpdateOverlay verwendet werden.
Verwenden Sie die DirectDrawCreateClipper-Funktion , um ein DirectDrawClipper-Objekt zu erstellen, das sich nicht im Besitz eines bestimmten DirectDraw-Objekts befindet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |