WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT関数 (wdfdmaenabler.h)

[KMDF にのみ適用]

WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT関数は、ドライバーのWDF_DMA_SYSTEM_PROFILE_CONFIG構造体を初期化します。

構文

void WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT(
       PWDF_DMA_SYSTEM_PROFILE_CONFIG  DmaConfig,
  [in] PHYSICAL_ADDRESS                Address,
  [in] DMA_WIDTH                       DmaWidth,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR DmaDescriptor
);

パラメーター

DmaConfig

ドライバーによって割り当てられた WDF_DMA_SYSTEM_PROFILE_CONFIG 構造体へのポインター。

[in] Address

DMA のターゲットとなるレジスタの変換されたアドレス。 詳細については、「解説」を参照してください。

[in] DmaWidth

Address で指定されたレジスタの幅。

[in] DmaDescriptor

EvtDevicePrepareHardware 中にデバイスが割り当てられた DMA チャネルの翻訳されたリソース記述子。

戻り値

なし

解説

通常、ドライバーは EvtDevicePrepareHardware コールバック関数内からWDF_DMA_SYSTEM_PROFILE_CONFIG_INITを呼び出します。 ドライバーは、WdfDmaEnablerConfigureSystemProfile を呼び出す前に、WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT関数を呼び出す必要があります。

System on a Chip (SoC) の設計によっては、 Address パラメーターの意味が異なる場合があります。 たとえば、DMA がデバイス上の専用転送ポートを使用する場合、 アドレス は DMA 書き込みが行われるポートを示している可能性があります。

システム モード DMA イネーブラーの作成の詳細については、「 System-Mode DMA のサポート」を参照してください。

例

WDF_DMA_SYSTEM_PROFILE_CONFIG_INITを使用するコード例については、「WdfDmaEnablerConfigureSystemProfile」を参照してください。

要件

こちらもご覧ください

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate