DrvAssertMode 関数 (winddi.h)

  • [アーティクル]

DrvAssertMode 関数は、指定された物理デバイスのモードを、PDEV の初期化時に指定されたモードまたはハードウェアの既定のモードに設定します。

構文

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

パラメーター

[in] dhpdev

bEnable が TRUE の場合に設定する必要があるハードウェア モードを記述する PDEV を処理します。

[in] bEnable

ハードウェアを設定するモードを指定します。 このパラメーターが TRUE の場合、ドライバーは、初期化された PDEV で指定された元のモードにハードウェアを設定する必要があります。 それ以外の場合、このパラメーターが FALSE の場合、ドライバーは、ビデオ ミニポート ドライバーが制御を引き受けることができるように、ハードウェアを既定のモードに設定する必要があります。

戻り値

表示モードが正常に変更された場合、DrvAssertMode は TRUE を返します。表示モードを変更できなかった場合は FALSE を返します。 ドライバーは、bEnable が FALSE に設定された DrvAssertMode 呼び出しから FALSE を返すことができます。 ドライバーは、bEnableを TRUE に設定した DrvAssertMode 呼び出しから TRUE を返す必要があります。つまり、ドライバーは、以前に有効にされたモードの有効化に失敗することはできません。

注釈

GDI は、1 つのディスプレイ画面で複数のデスクトップを切り替える必要がある場合に DrvAssertMode を呼び出します。 ある PDEV から別の PDEV に切り替えるには、GDI は DrvAssertMode を呼び出し、 bEnable パラメーターを 1 つの PDEV に 対して FALSE 、もう一方の PDEV に 対して TRUE を 設定します。 元の PDEV に戻すには、bEnable を FALSE に設定して DrvAssertMode を呼び出し、次に DrvAssertMode を別の呼び出しで呼び出し、bEnable を TRUE に設定し、dhpdev を元の PDEV に設定します。

物理デバイスがパレットで管理されている場合、GDI は DrvSetPalette を呼び出してデバイスのパレットをリセットします。 ウィンドウ マネージャーが正しいポインターの図形を選択し、現在の位置に移動するため、ドライバーは現在のポインターの状態を追跡する必要はありません。 コンソール マネージャーは、デスクトップが適切に再描画されるようにします。

DrvAssertMode は、ディスプレイ ドライバーに実装する必要があります。

要件

要件 値
対象プラットフォーム デスクトップ
Header winddi.h (Winddi.h を含む)

こちらもご覧ください

DrvGetModes

DrvSetPalette