Función GetRegionData (wingdi.h)

Artículo
03/13/2024

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