情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

EvtDmaEnablerDisable

A driver's EvtDmaEnablerDisable event callback function disables a device's DMA capability before the device leaves its working (D0) state.

構文

EVT_WDF_DMA_ENABLER_DISABLE EvtDmaEnablerDisable;

NTSTATUS EvtDmaEnablerDisable(
  __in  WDFDMAENABLER DmaEnabler
)
{ ... }

パラメーター

DmaEnabler [in]

A handle to a DMA enabler object.

戻り値

EvtDmaEnablerDisable must return STATUS_SUCCESS or another status value for which NT_SUCCESS(status) equals TRUE, if it encounters no errors. Otherwise, this callback function must return a status value for which NT_SUCCESS(status) equals FALSE.

解説

To register an EvtDmaEnablerDisable callback function, a function driver for a DMA device places the callback function's address in a WDF_DMA_ENABLER_CONFIG structure before the driver calls WdfDmaEnablerCreate.

For more information about the EvtDmaEnablerDisable callback function, see Supporting Power Management for DMA Devices.

The function type is declared in WdfDmaEnabler.h, as follows.

typedef NTSTATUS
  (EVT_WDF_DMA_ENABLER_DISABLE)(
    IN WDFDMAENABLER  DmaEnabler
    );

To define an EvtDmaEnablerDisable callback function that is named MyDmaEnablerDisable, you must first provide a function declaration that SDV and other verification tools require, as follows:

EVT_WDF_DMA_ENABLER_DISABLE  MyDmaEnablerDisable;

Then, implement your callback function as follows:

NTSTATUS
 MyDmaEnablerDisable (
    IN WDFDMAENABLER  DmaEnabler
    )
  {...}

要件

バージョン

Supported by version 1.0 and later versions of KMDF.

ヘッダー

WdfDmaEnabler.h (includeWdf.h)

IRQL

PASSIVE_LEVEL

参照

EvtDmaEnablerEnable
WDF_DMA_ENABLER_CONFIG
WdfDmaEnablerCreate

 

 

コミュニティの追加

表示:
© 2014 Microsoft