PFN_DrvAssertMode

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

DrvAssertMode は、表示モードの変更に成功した場合は TRUE を返し、表示モードを変更できなかった場合は FALSE を返します。ドライバーは、bEnable に FALSE を設定した DrvAssertMode の呼び出しに対して FALSE を返すことが許可されています。ドライバーは、bEnable に TRUE を設定した DrvAssertMode の呼び出しに対しては TRUE を返さなければなりません。つまり、ドライバーは、以前に有効化されていたモードの有効化に失敗することはできません。

GDI は、単一の表示サーフェス上で複数のデスクトップを切り替える必要があるときに DrvAssertMode を呼び出します。ある PDEV から別の PDEV へ切り替えるために、GDI は、一方の PDEV に対しては bEnable パラメーターを FALSE に設定し、もう一方に対しては TRUE に設定して DrvAssertMode を呼び出します。元の PDEV に戻すには、bEnable を FALSE に設定して DrvAssertMode を呼び出し、続いて bEnable を TRUE、dhpdev を元の PDEV に設定して DrvAssertMode をもう一度呼び出します。

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

DrvAssertMode は、ディスプレイドライバーに実装されていなければなりません。