EVT_WDF_DMA_ENABLER_ENABLE コールバック関数 (wdfdmaenabler.h)
[KMDF にのみ適用]
ドライバーの EvtDmaEnablerEnable イベント コールバック関数は、デバイスが動作 (D0) 状態に入った後に、デバイスの DMA 機能を有効にします。
構文
EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;
NTSTATUS EvtWdfDmaEnablerEnable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
パラメーター
[in] DmaEnabler
DMA イネーブラー オブジェクトへのハンドル。
戻り値
EvtDmaEnablerEnable は、エラーが発生しない場合STATUS_SUCCESSまたはNT_SUCCESS(status) が TRUE に等しい別の状態値を返す必要があります。 それ以外の場合、このコールバック関数は、NT_SUCCESS(status) が FALSE の状態値を返す必要があります。
注釈
EvtDmaEnablerEnable コールバック関数を登録するために、DMA デバイスの関数ドライバーは、ドライバーが WdfDmaEnablerCreate を呼び出す前に、コールバック関数のアドレスを WDF_DMA_ENABLER_CONFIG 構造体に配置します。
EvtDmaEnablerEnable コールバック関数の詳細については、「DMA デバイスの Power Management のサポート」を参照してください。
EvtDmaEnablerEnable コールバック関数は、IRQL = PASSIVE_LEVELで呼び出されます。 このコールバック関数を ページング可能にしないでください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdfdmaenabler.h (Wdf.h を含む) |
| IRQL | PASSIVE_LEVEL (「解説」セクションを参照) |