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」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.11 |
| Header | wdfdmaenabler.h (Wdf.h を含む) |