DrvGetDirectDrawInfo 函式 (winddi.h)

發行項
03/04/2024

DrvGetDirectDrawInfo 函式會傳回圖形硬體的功能。

語法

BOOL DrvGetDirectDrawInfo(
  DHPDEV      dhpdev,
  DD_HALINFO  *pHalInfo,
  DWORD       *pdwNumHeaps,
  VIDEOMEMORY *pvmList,
  DWORD       *pdwNumFourCCCodes,
  DWORD       *pdwFourCC
);

參數

dhpdev

驅動程式DrvEnablePDEV例程傳回的PDEV句柄。

pHalInfo

指向驅動程式應該傳回其支持的硬體功能 DD_HALINFO 結構。

pdwNumHeaps

指向驅動程式應該傳回 pvmList 所指向的 VIDEOMEMORY 結構數目的位置。

pvmList

指向 VIDEOMEMORY 結構的數位，驅動程式應該傳回其所控制之每個顯示記憶體區塊的相關信息。當這個參數為 NULL時，驅動程序應該忽略此參數。

pdwNumFourCCCodes

指向驅動程式應該傳回 pdwFourCC 所指向之 DWORD 數目的位置。

pdwFourCC

指向 DWORD 的陣列，驅動程式應該傳回其支援之每個 FOURCC 的相關信息。當這個參數為 NULL時，驅動程序應該忽略此參數。

傳回值

DrvGetDirectDrawInfo 如果成功，則會傳回 TRUE ;否則會傳回 FALSE。

備註

驅動程式的 DrvGetDirectDrawInfo 例程應該執行下列動作：

當 pvmList 和 pdwFourCC 為 NULL 時：
1. 保留螢幕外顯示記憶體以供 DirectDraw 使用。
2. 分別在 pdwNumHeaps 和 pdwNumFourCC 中寫入驅動程序顯示記憶體堆積和支援的 FOURC 數目。
當 pvmList 和 pdwFourCC 不是 NULL 時：
1. 分別在 pdwNumHeaps 和 pdwNumFourCC 中寫入驅動程序顯示記憶體堆積和支援的 FOURC 數目。
2. 針對 pvmList 點清單中每個 VIDEOMEMORY 結構，填入適當的成員來描述特定顯示記憶體區塊。結構清單會提供 DirectDraw，並完整描述驅動程式的外螢幕記憶體。
使用驅動程式特定資訊，初始化 DD_HALINFO 結構的成員，如下所示：
1. 初始化 vmiData 中 VIDEOMEMORYINFO 結構的適當成員，以描述顯示器記憶體的一般特性。
2. 初始化 ddCaps 中 DDCORECAPS 結構的適當成員，以描述硬體的功能。
3. 如果驅動程序實作 DdGetDriverInfo 函式，請將 GetDriverInfo 設定為指向它，並將 dwFlags 設定為 DDHALINFO_GETDRIVERINFOSET。