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
Header	wudfddi.h (Wudfddi.h を含む)
[DLL]	WUDFx.dll

こちらもご覧ください

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize