PFN_DrvGetModes

コールバック

シグネチャ

DWORD PFN_DrvGetModes(
    HANDLE param0,
    DWORD param1,
    DEVMODEW* param2
);

パラメーター

フィールド	型
param0	HANDLE
param1	DWORD
param2	DEVMODEW*

公式ドキュメント

DrvGetModes 関数は、指定されたデバイスがサポートするモードを列挙します。

戻り値

pdm が NULL でない場合、ドライバーはバッファーに書き込んだバイト数を返します。pdm が NULL の場合、ドライバーはすべてのモードデータを格納するために必要なバイト数を返します。エラーが発生した場合、ドライバーは 0 を返します。

解説(Remarks)

この関数は、すべてのディスプレイドライバーで実装する必要があります。

ウィンドウマネージャーは、(レジストリの InstalledDisplayDrivers キーに基づいて) ミニポートドライバーに関連付けられたすべてのディスプレイドライバーを動的に読み込みます。読み込まれたドライバーの組み合わせがサポートするモードの一覧を取得するために、各ディスプレイドライバーが呼び出されます。たとえば VGA64K ディスプレイドライバーは、ミニポートドライバーから取得したモードの一覧に含まれていた 64K カラーモードのみを返します。

DrvGetModes は、アクティブな PDEV が存在しない状態でも呼び出されることがあります。

DrvGetModes の動作する実装例については、Permedia サンプルを参照してください。

注 Microsoft Windows Driver Kit (WDK) には、3Dlabs Permedia2 (3dlabs.htm ) および 3Dlabs Permedia3 (Perm3.htm) のサンプルディスプレイドライバーは含まれていません。これらのサンプルドライバーは、WDHC Web サイトの DDK - Windows Driver Development Kit ページからダウンロードできる Windows Server 2003 SP1 Driver Development Kit (DDK) から入手できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)