次の方法で共有


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

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

[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を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
ターゲット プラットフォーム 普遍
最小 KMDF バージョン 1.11
ヘッダー wdfdmaenabler.h (Wdf.h を含む)

こちらもご覧ください

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate