drvGetModes 函式 (winddi.h)

發行項
03/13/2024

DrvGetModes 函式會列出指定裝置支援的模式。

語法

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

參數

[in] hDriver

必須列舉模式的驅動程式句柄。這是在DrvEnablePDEV函式的 hDriver 參數中傳遞的句柄。

cjSize

指定 pdm 所指向之緩衝區的位元元組大小。

[out, optional] pdm

緩衝區的指標，其中包含 DEVMODEW 結構， (s) ，讓驅動程式填入或 NULL。

傳回值

如果 pdm 不是 NULL，驅動程式應該會傳回寫入緩衝區的位元元組數目。如果 pdm 為 NULL，驅動程式應該傳回保存所有模式數據所需的位元元組數目。如果發生錯誤，驅動程式應該會傳回零。

備註

此函式必須在所有顯示驅動程序中實作。

視窗管理員會根據登錄) 中的 InstalledDisplayDrivers 機碼，動態載入與迷你埠驅動程式相關聯的所有顯示驅動程式 (。系統會呼叫每個顯示驅動程式，以擷取載入驅動程式組合所支援的模式清單。例如，VGA64K 顯示驅動程式只會傳回從迷你埠驅動程式取得之模式清單中傳回的 64K 色彩模式。

DrvGetModes 可以在有作用中的 PDEV 之前呼叫。

請參閱 Permedia 範例，以查看 DrvGetModes 的工作實作。

注意 Microsoft Windows Driver Kit (WDK) 不包含 3Dlabs Permedia2 (3dlabs.htm) 和 3Dlabs Permedia3 (Perm3.htm) 範例顯示驅動程式。您可以從 Windows Server 2003 SP1 驅動程式開發工具包取得這些範例驅動程式， (DDK) ，您可以從 WDHC 網站的 DDK - Windows 驅動程式開發工具包頁面下載。