Función GetRegionData (wingdi.h)
La función GetRegionData rellena el búfer especificado con datos que describen una región. Estos datos incluyen las dimensiones de los rectángulos que componen la región.
Sintaxis
DWORD GetRegionData(
[in] HRGN hrgn,
[in] DWORD nCount,
[out] LPRGNDATA lpRgnData
);
Parámetros
[in] hrgn
Identificador de la región.
[in] nCount
Tamaño, en bytes, del búfer lpRgnData .
[out] lpRgnData
Puntero a una estructura RGNDATA que recibe la información. Las dimensiones de la región están en unidades lógicas. Si este parámetro es NULL, el valor devuelto contiene el número de bytes necesarios para los datos de la región.
Valor devuelto
Si la función se ejecuta correctamente y nCount especifica un número adecuado de bytes, el valor devuelto es igual al número real de bytes usados (menor o igual que nCount).
Si lpRgnData es NULL, el valor devuelto es el número necesario de bytes.
Si se produce un error en la función, el valor devuelto es cero.
Si el error se debe a que hrgn no es válido, GetLastError devuelve ERROR_INVALID_HANDLE. De lo contrario, GetLastError devuelve ERROR_INVALID_PARAMETER .
Si nCount es demasiado pequeño, se produce un error en la función.
Comentarios
La función GetRegionData se usa junto con la función ExtCreateRegion .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |