DrvGetModes 関数 (winddi.h)

[アーティクル]
03/09/2024

DrvGetModes 関数は、特定のデバイスでサポートされているモードを一覧表示します。

構文

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

パラメーター

[in] hDriver

モードを列挙する必要があるドライバーを処理します。これは、DrvEnablePDEV 関数の hDriver パラメーターで渡されるハンドルです。

cjSize

pdm が指すバッファーのサイズをバイト単位で指定します。

[out, optional] pdm

ドライバーが入力する DEVMODEW 構造体を含むバッファーへのポインター( NULL)。

戻り値

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

注釈

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

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

アクティブな PDEV が存在する前に、DrvGetModes を呼び出すことができます。

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

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