WNDOBJ_cEnumStart función (winddi.h)
La función WNDOBJ_cEnumStart es una función de devolución de llamada que establece parámetros para la enumeración de rectángulos en la región visible de una ventana.
Sintaxis
ENGAPI ULONG WNDOBJ_cEnumStart(
WNDOBJ *pwo,
ULONG iType,
ULONG iDirection,
ULONG cLimit
);
Parámetros
pwo
Puntero a una estructura WNDOBJ creada por una llamada a EngCreateWnd.
iType
Especifica el tipo de estructuras que va a devolver WNDOBJ_bEnum. Este parámetro puede ser CT_RECTANGLES, lo que significa que la región se va a enumerar como una lista de rectángulos.
iDirection
Determina el orden en que se devuelven los rectángulos. Este orden puede ser esencial cuando se realiza una drvBitBlt superpuesta en la misma superficie. Si el pedido no es relevante para el controlador de dispositivo, se debe especificar CD_ANY. Esto permite que GDI optimice su enumeración para regiones complejas. Este parámetro puede ser uno de los valores siguientes:
| Valor | Significado |
|---|---|
| CD_ANY | Cualquier orden conveniente para GDI. |
| CD_LEFTDOWN | De derecha a izquierda, de arriba abajo. |
| CD_LEFTUP | De derecha a izquierda, de abajo a arriba. |
| CD_LEFTWARDS | De izquierda a derecha, no se define la dirección vertical. |
| CD_RIGHTDOWN | De izquierda a derecha, de arriba abajo. |
| CD_RIGHTUP | De izquierda a derecha, de abajo a arriba. |
| CD_UPWARDS | De abajo a arriba, no se define la dirección horizontal. |
cLimit
Es una indicación del número de objetos que el controlador está interesado en el almacenamiento en caché. Esto solo se usa para decidir cuándo detener el recuento de rectángulos mientras GDI calcula el valor devuelto de esta función. Si cLimit es cero, no se realiza el recuento.
Valor devuelto
El valor devuelto es un recuento del número de objetos que se enumerarían, siempre que este valor sea menor o igual que cLimit. Si el recuento es mayor que cLimit, el valor devuelto es 0xFFFFFFFF.
Comentarios
La enumeración se puede reiniciar llamando de nuevo a esta función.
solo se debe llamar a WNDOBJ_cEnumStart:
- En el contexto de la función de devolución de llamada del controlador proporcionada a GDI en la función EngCreateWnd , o las funciones DDI de gráficos donde se proporciona un WNDOBJ.
- Cuando el subproceso que realiza la llamada tiene el bloqueo del dispositivo para asegurarse de que no se producen cambios en la región de cliente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |