共用方式為

DrvDescribePixelFormat 函式 (winddi.h)

  • 發行項

DrvDescribePixelFormat函式藉由將像素格式描述寫入至 PIXELFORMATDESCRIPTOR 結構來描述裝置指定的PDEV像素格式。

語法

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

參數

dhpdev

識別要求像素格式資訊的裝置。

iPixelFormat

指定所要求像素格式的索引編號。

cjpfd

指定可寫入 ppfd所指向結構的最大位元組數目。

ppfd

Microsoft Windows SDK檔中說明 (的 PIXELFORMATDESCRIPTOR 結構的指標，) ，以接收像素格式的相關資訊。 此參數可以是 Null。

傳回值

如果函式成功，則傳回值為最大像素格式索引。 否則，它會是零，而且會記錄錯誤碼。

備註

支援 3D 圖形硬體的顯示驅動程式，可以在單一顯示介面上支援具有不同像素格式的視窗。 像素格式必須對應至圖形硬體支援的組態。

如果此參數不是Null，DrvDescribePixelFormat會填入ppfd所指向的結構。

需要取得裝置內容的最大像素格式索引的應用程式可以使用傳回的最大像素格式索引。 裝置支援的像素格式是由正一整數索引所識別。

像素格式函式會與視窗物件服務函式搭配使用，以追蹤及更新顯示介面上的視窗像素格式。

規格需求

   
目標平台 桌上型
標頭 winddi.h (包括 Winddi.h)