次の方法で共有


IWDFDeviceInitialize::AutoForwardCreateCleanupClose メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。

AutoForwardCreateCleanupClose メソッドは、デバイス スタック内の次の下位ドライバーに通知を作成、クリーンアップ、および閉じるときに制御します。

構文

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

パラメーター

[in] State

自動転送の状態を識別するWDF_TRI_STATE型指定された値。 次の表に、使用可能な値を示します。

価値 意味
WdfUseDefault (0) フレームワークでは、既定の転送スキームが使用されます。 詳細については、次の「解説」セクションを参照してください。
WdfFalse (1) フレームワークは、作成、クリーンアップ、および閉じる通知を次の下位ドライバーに転送しません。
WdfTrue (2) フレームワークは、作成、クリーンアップ、および閉じる通知を次の下位ドライバーに同期的に転送します。

戻り値

何一つ

備考

UMDF ドライバーが、AutoForwardCreateCleanupCloseの呼び出しで State パラメーターの WdfUseDefault 渡す場合、フレームワークは既定の転送スキームを使用して、ドライバーがフィルタードライバーか関数ドライバーかに依存する通知を作成、クリーンアップ、および閉じます。

  • ドライバーがフィルター ドライバーの場合、既定の転送スキームは、次の下位ドライバーに同期的に通知を転送することです。
  • ドライバーがファンクション ドライバーの場合、既定の転送スキームは、次の下位ドライバーに通知を転送しません。
フレームワークが転送用に設定されている場合、ドライバーが IFileCallbackCleanup::OnCleanupFile および IFileCallbackClose::OnCloseFile インターフェイス メソッド サポートしているかどうかに関係なく、クリーンアップと終了通知を転送します。 ただし、フレームワークは、ドライバーが IQueueCallbackCreate::OnCreateFile メソッドをサポートしていない場合にのみ、作成要求を自動的に転送します。 ドライバーが IQueueCallbackCreate::OnCreateFileをサポートしている場合、フレームワークは、ドライバーが明示的に転送 (WdfTrue) を次の下位ドライバーに設定した場合にのみ、作成要求を転送します。

UMDF ドライバーが AutoForwardCreateCleanupClose 使用する方法の詳細については、「ドライバーに対する通知の作成と終了の不均衡を防止する」を参照してください。

必要条件

要件 価値
サポート終了 UMDF 2.0 以降では使用できません。
ターゲット プラットフォーム デスクトップ
UMDF の最小バージョン する 1.5
ヘッダー wudfddi.h (Wudfddi.h を含む)
DLL WUDFx.dll

関連項目

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize