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 (「解説」セクションを参照)

こちらもご覧ください

EvtDmaEnablerDisable

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate