funzione WNDOBJ_cEnumStart (winddi.h)

Articolo
08/27/2023

La funzione WNDOBJ_cEnumStart è una funzione di callback che imposta i parametri per l'enumerazione di rettangoli nell'area visibile di una finestra.

Sintassi

ENGAPI ULONG WNDOBJ_cEnumStart(
  WNDOBJ *pwo,
  ULONG  iType,
  ULONG  iDirection,
  ULONG  cLimit
);

Parametri

pwo

Puntatore a una struttura WNDOBJ creata da una chiamata a EngCreateWnd.

iType

Specifica il tipo di strutture da restituire da WNDOBJ_bEnum. Questo parametro può essere CT_RECTANGLES, ovvero l'area deve essere enumerata come elenco di rettangoli.

iDirection

Determina l'ordine in cui vengono restituiti i rettangoli. Questo ordine può essere essenziale quando viene eseguita una sovrapposizione di DrvBitBlt sulla stessa superficie. Se l'ordine non è pertinente al driver del dispositivo, CD_ANY deve essere specificato. Ciò consente a GDI di ottimizzare l'enumerazione per aree complesse. Questo parametro può essere uno dei valori 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_LEFTWARDS	La direzione verticale a sinistra a destra non è definita.
CD_RIGHTDOWN	Da sinistra a destra, in alto verso il basso.
CD_RIGHTUP	Da sinistra a destra, in basso verso l'alto.
CD_UPWARDS	In basso verso l'alto, la direzione orizzontale non è definita.

cLimit

Indica quanti oggetti il driver è interessato alla memorizzazione nella cache. Viene usato solo per decidere quando arrestare i rettangoli di conteggio mentre GDI calcola il valore restituito per questa funzione. Se cLimit è zero, il conteggio non viene eseguito.

Valore restituito

Il valore restituito è un conteggio del numero di oggetti che verranno enumerati, purché questo valore sia minore o uguale a cLimit. Se il conteggio è maggiore di cLimit, il valore restituito è 0xFFFFFFFF.

Commenti

L'enumerazione può essere riavviata chiamando nuovamente questa funzione.

WNDOBJ_cEnumStart deve essere chiamato solo:

Nel contesto della funzione di callback del driver fornita a GDI nella funzione EngCreateWnd o nelle funzioni DDI grafiche in cui viene specificato un WNDOBJ.
Quando il thread chiamante ha il blocco del dispositivo per assicurarsi che non si verifichino modifiche all'area client.

Requisiti

Requisito	Valore
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

Vedi anche

Condividi tramite