DIBSECTION 結構 (wingdi.h)

發行項
03/13/2024

DIBSECTION 結構包含透過呼叫 CreateDIBSection 函式所建立之 DIB 的相關信息。 DIBSECTION 結構包含位圖維度、色彩格式、色彩遮罩、選擇性檔案對應對象和選擇性位值儲存位移的相關信息。應用程式可以藉由呼叫 GetObject 函式，取得指定 DIB 的填入 DIBSECTION 結構。

語法

typedef struct tagDIBSECTION {
  BITMAP           dsBm;
  BITMAPINFOHEADER dsBmih;
  DWORD            dsBitfields[3];
  HANDLE           dshSection;
  DWORD            dsOffset;
} DIBSECTION, *LPDIBSECTION, *PDIBSECTION;

成員

dsBm

BITMAP 數據結構，其中包含 DIB 的相關信息：其類型、維度、色彩容量，以及其位值的指標。

dsBmih

BITMAPINFOHEADER 結構，其中包含 DIB 色彩格式的相關信息。

dsBitfields[3]

指定 DIB 的三個色彩遮罩。只有在 BITMAPINFOHEADER 結構的 BitCount 成員具有大於 8 的值時，此字段才有效。每個色彩遮罩會指出用來編碼三個色彩通道的其中一個位， (紅色、綠色和藍色) 。

dshSection

包含用來建立 DIB 之 CreateDIBSection 函式之檔案對應物件的句柄。如果使用 hSection 參數的 NULL 值呼叫 CreateDIBSection，導致系統為位圖配置記憶體，dshSection 成員會是 NULL。

dsOffset

dshSection 所參考檔案對應物件內位值的位移。如果 dshSection 為 NULL，dsOffset 值就沒有意義。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	wingdi.h (包含 Windows.h)