Share via

DescribePixelFormat 函式 (wingdi.h)

  • 發行項

DescribePixelFormat 函式會取得與 hdc 相關聯之裝置 iPixelFormat 所識別之圖元格式的相關信息。 函式會設定 ppfd 使用該圖元格式數據所指向的 PIXELFORMATDESCRIPTOR 結構成員。

語法

int DescribePixelFormat(
  HDC                     hdc,
  int                     iPixelFormat,
  UINT                    nBytes,
  LPPIXELFORMATDESCRIPTOR ppfd
);

參數

hdc

指定裝置內容。

iPixelFormat

指定像素格式的索引。 裝置內容支援的圖元格式是由正一整數索引所識別。

nBytes

ppfd 所指向之結構的大小，以位元組為單位。 DescribePixelFormat 函式不會儲存超過 nBytes 位元組的數據至該結構。 將此值設定為 sizeof (PIXELFORMATDESCRIPTOR) 。

ppfd

PIXELFORMATDESCRIPTOR 結構的指標，其函式會設定圖元格式數據的成員。 函式會將複製到 結構之 nSize 成員中的位元元組數目儲存。 如果 ppfd 在輸入時為 NULL，則函式不會將數據寫入結構。 當您只想要取得裝置內容的最大圖元格式索引時，這會很有用。

傳回值

如果函式成功，則傳回值是裝置內容的最大圖元格式索引。 此外，函式會根據指定的圖元格式，設定 ppfd 所指向的 PIXELFORMATDESCRIPTOR 結構成員。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

ChoosePixelFormat

GetPixelFormat

Windows 上的 OpenGL

SetPixelFormat

Windows 函式