DrvDisableSurface 関数 (winddi.h)
DrvDisableSurface 関数は、現在のデバイスの DrvEnableSurface によって作成されたサーフェスが不要になったことをドライバーに通知するために GDI によって使用されます。
構文
void DrvDisableSurface(
DHPDEV dhpdev
);
パラメーター
dhpdev
物理デバイスの PDEV を処理します。 これは、サーフェスが解放されるデバイスへのハンドルです。
戻り値
なし
解説
ドライバーは、物理デバイスが無効になるとすぐに、PDEV に関連付けられているサーフェスによって使用されるメモリとリソースを解放する必要があります。
ドライバーが DrvAssertMode の呼び出しによって無効になっている場合、別のアクティブな PDEV が使用されている可能性があるため、ドライバーは DrvDisableSurface 中にハードウェアにアクセスできません。 必要なハードウェア変更は、 DrvAssertMode の呼び出し中に実行する必要があります。 ドライバーは、DrvDisableSurface で適切なクリーンアップ操作を実行できるように、DrvAssertMode によって無効にされているかどうかを追跡する必要があります。
物理デバイスのサーフェスが有効になっている場合、GDI は DrvDisablePDEV を呼び出す前に DrvDisableSurface を呼び出します。
グラフィックス ドライバーには DrvDisableSurface が必要です。
要件
対象プラットフォーム | デスクトップ |
Header | winddi.h (Winddi.h を含む) |