Funzione GetRegionData (wingdi.h)
La funzione GetRegionData riempie il buffer specificato con i dati che descrivono un'area. Questi dati includono le dimensioni dei rettangoli che costituiscono l'area.
Sintassi
DWORD GetRegionData(
[in] HRGN hrgn,
[in] DWORD nCount,
[out] LPRGNDATA lpRgnData
);
Parametri
[in] hrgn
Handle per l'area.
[in] nCount
Dimensione, in byte, del buffer lpRgnData .
[out] lpRgnData
Puntatore a una struttura RGNDATA che riceve le informazioni. Le dimensioni dell'area sono in unità logiche. Se questo parametro è NULL, il valore restituito contiene il numero di byte necessari per i dati dell'area.
Valore restituito
Se la funzione ha esito positivo e nCount specifica un numero adeguato di byte, il valore restituito è uguale al numero effettivo di byte usati (minore o uguale a nCount).
Se lpRgnData è NULL, il valore restituito è il numero di byte richiesto.
Se la funzione ha esito negativo, il valore restituito è zero.
Se l'errore è dovuto a hrgn non valido, GetLastError restituisce ERROR_INVALID_HANDLE. In caso contrario, GetLastError restituisce ERROR_INVALID_PARAMETER .
Se nCount è troppo piccolo, la funzione ha esito negativo.
Commenti
La funzione GetRegionData viene utilizzata insieme alla funzione ExtCreateRegion .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | wingdi.h (include Windows.h) |
| Libreria | Gdi32.lib |
| DLL | Gdi32.dll |