funzione CLIPOBJ_cEnumStart (winddi.h)
La funzione CLIPOBJ_cEnumStart imposta i parametri per l'enumerazione dei rettangoli in un'area di clip specificata.
Sintassi
ENGAPI ULONG CLIPOBJ_cEnumStart(
[in] CLIPOBJ *pco,
[in] BOOL bAll,
[in] ULONG iType,
[in] ULONG iDirection,
[in] ULONG cLimit
);
Parametri
[in] pco
Puntatore alla struttura CLIPOBJ che definisce l'area clip da enumerare.
[in] bAll
Specifica se l'intera area deve essere enumerata. Questo parametro è TRUE se l'intera area deve essere enumerata. È FALSE se devono essere enumerate solo le parti rilevanti per l'operazione di disegno corrente.
Un driver che memorizza nella cache le aree clip deve enumerare l'intera area.
[in] iType
Specifica le strutture di dati che devono essere scritte da CLIPOBJ_bEnum. Questo parametro attualmente deve essere CT_RECTANGLES, che indica che l'area deve essere enumerata come elenco di rettangoli.
[in] iDirection
Determina l'ordine in cui devono essere enumerati i rettangoli. Questo ordine può essere essenziale se un'operazione DrvBitBlt viene eseguita simultaneamente sulla stessa superficie. Se l'ordine non è pertinente al driver del dispositivo, CD_ANY deve essere specificato per aree complesse, consentendo a GDI di ottimizzare l'enumerazione. I valori validi sono i seguenti:
| Valore | Significato |
|---|---|
| CD_ANY | Qualsiasi ordine pratico per GDI. |
| CD_LEFTDOWN | Da destra a sinistra, in alto verso il basso. |
| CD_LEFTUP | Da destra a sinistra, in basso verso l'alto. |
| CD_RIGHTDOWN | Da sinistra a destra, in alto verso il basso. |
| CD_RIGHTUP | Da sinistra a destra, in basso verso l'alto. |
[in] cLimit
Specifica il numero massimo di rettangoli da enumerare. Se questo parametro è zero, il conteggio viene omesso.
Valore restituito
Il valore restituito è il numero di rettangoli enumerati. Se il conteggio supera cLimit, il valore restituito è 0xFFFFFFFF.
Commenti
Un'area può essere enumerata se questa funzione viene chiamata. Per impostazione predefinita, il driver enumera solo i rettangoli pertinenti, a partire dall'alto a sinistra.
Il driver può riavviare l'enumerazione chiamando nuovamente questa funzione.
Requisiti
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |