GetRegionData 函式 (wingdi.h)

GetRegionData 函式會以描述區域的數據填滿指定的緩衝區。此數據報括組成區域之矩形的維度。

語法

DWORD GetRegionData(
  [in]  HRGN      hrgn,
  [in]  DWORD     nCount,
  [out] LPRGNDATA lpRgnData
);

[in] hrgn

區域的句柄。

[in] nCount

lpRgnData 緩衝區的大小，以位元組為單位。

[out] lpRgnData

接收資訊的 RGNDATA 結構的指標。區域的維度以邏輯單位表示。如果此參數為 NULL，則傳回值會包含區域數據所需的位元元組數目。

如果函式成功， 且 nCount 指定足夠的位元組數目，則傳回值會等於實際使用的位元元組數目， (小於或等於 nCount) 。

如果 lpRgnData 為 NULL，則傳回值是所需的位元元數目。

如果函式失敗，則傳回值為零。

如果失敗是因為 hrgn 無效， GetLastError 會傳回 ERROR_INVALID_HANDLE。否則， GetLastError 會傳回 ERROR_INVALID_PARAMETER 。

如果 nCount 太小，則函式會失敗。

GetRegionData 函式會與 ExtCreateRegion 函式搭配使用。