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 を含む)

関連項目

DrvAssertMode

DrvDisableDriver

DrvDisablePDEV

DrvEnableSurface