fonction WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)

[S’applique uniquement à KMDF]

La fonction WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT initialise la structure WDF_DMA_SYSTEM_PROFILE_CONFIG d’un pilote.

Syntaxe

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
);

Paramètres

DmaConfig

Pointeur vers une structure de WDF_DMA_SYSTEM_PROFILE_CONFIG allouée par le pilote.

[in] Address

Adresse traduite du registre à la cible pour DMA. Pour plus d'informations, consultez la section Notes.

[in] DmaWidth

Largeur du registre spécifiée par Address.

[in] DmaDescriptor

Le descripteur de ressources traduit pour le canal DMA a affecté l’appareil pendant EvtDevicePrepareHardware.

Valeur de retour

None

Remarques

En règle générale, un pilote appelle WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT à partir de sa fonction de rappel EvtDevicePrepareHardware . Un pilote doit appeler la fonction WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT avant d’appeler WdfDmaEnablerConfigureSystemProfile.

Selon la conception du Système sur une puce (SoC), le paramètre Address peut avoir une signification différente. Par exemple, si DMA utilise des ports de transfert dédiés sur l’appareil, Address peut indiquer le port sur lequel les écritures DMA se produisent.

Pour plus d’informations sur la création d’un enabler DMA en mode système, consultez Prise en charge System-Mode DMA.

Exemples

Pour obtenir un exemple de code qui utilise WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, consultez WdfDmaEnablerConfigureSystemProfile.

Configuration requise

Voir aussi

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate