IDirectDrawClipper::GetClipList-Methode (ddraw.h)
Ruft eine Kopie der Clipliste ab, die einem DirectDrawClipper-Objekt zugeordnet ist. Um eine Teilmenge der Clipliste auszuwählen, können Sie ein Rechteck übergeben, das die Clipliste ausschneidet.
Syntax
HRESULT GetClipList(
[in] LPRECT unnamedParam1,
[out] LPRGNDATA unnamedParam2,
[out] LPDWORD unnamedParam3
);
Parameter
[in] unnamedParam1
Ein Zeiger auf eine RECT-Struktur , die GetClipList zum Beschneiden der Clipliste verwendet. Legen Sie diesen Parameter auf NULL fest, um die gesamte Clipliste abzurufen.
[out] unnamedParam2
Ein Zeiger auf eine RGNDATA-Struktur , die die resultierende Kopie der Clipliste empfängt. Wenn dieser Parameter NULL ist, füllt GetClipList die Variable bei lpdwSize mit der Anzahl von Bytes aus, die zum Speichern der gesamten Clipliste erforderlich sind.
[out] unnamedParam3
Ein Zeiger auf eine Variable, die die Größe der resultierenden Clipliste empfängt. Beim Abrufen der Clipliste entspricht dieser Parameter der Größe des Puffers bei lpClipList. Wenn lpClipList NULL ist, empfängt die Variable bei lpdwSize die erforderliche Größe des Puffers in Bytes.
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_GENERIC
- DDERR_INVALIDCLIPLIST
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCLIPLIST
- DDERR_REGIONTOOSMALL
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |