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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 |
| Plateforme cible | Universal |
| Version KMDF minimale | 1.11 |
| En-tête | wdfdmaenabler.h (inclure Wdf.h) |