Win32 API 日本語リファレンス
ホーム › Devices.Display › PFN_DrvDisableSurface

PFN_DrvDisableSurface

コールバック

シグネチャ

void PFN_DrvDisableSurface(
    DHPDEV param0
);

パラメーター

フィールド型
param0DHPDEV

公式ドキュメント

DrvDisableSurface 関数は、現在のデバイス用に DrvEnableSurface が作成したサーフェスがもう必要ないことをドライバーに通知するために、GDI が使用します。

解説(Remarks)

ドライバーは、物理デバイスが無効化されたらすぐに、PDEV に関連付けられたサーフェスが使用しているメモリとリソースを解放する必要があります。

DrvAssertMode の呼び出しによってドライバーが無効化されている場合、別のアクティブな PDEV が使用中である可能性があるため、ドライバーは DrvDisableSurface の実行中にハードウェアへアクセスしてはなりません。必要なハードウェアの変更は、DrvAssertMode の呼び出し中に済ませておく必要があります。ドライバーは、DrvAssertMode によって無効化されたかどうかを記録しておき、DrvDisableSurface で適切なクリーンアップ処理を実行できるようにしてください。

物理デバイスに有効なサーフェスがある場合、GDI は DrvDisablePDEV を呼び出す前に DrvDisableSurface を呼び出します。

DrvDisableSurface はグラフィックスドライバーでは必須です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)