funzione WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)
[Si applica solo a KMDF]
La funzione WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT inizializza la struttura di WDF_DMA_SYSTEM_PROFILE_CONFIG di un driver.
Sintassi
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
);
Parametri
DmaConfig
Puntatore a una struttura di WDF_DMA_SYSTEM_PROFILE_CONFIG allocata dal driver.
[in] Address
Indirizzo tradotto del registro di destinazione per DMA. Per altre informazioni, vedere la sezione Osservazioni.
[in] DmaWidth
Larghezza del registro specificata da Address.
[in] DmaDescriptor
Il descrittore di risorse tradotto per il canale DMA assegnato al dispositivo durante EvtDevicePrepareHardware.
Valore restituito
nessuno
Osservazioni
In genere, un driver chiama WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT dall'interno della sua funzione di callback EvtDevicePrepareHardware . Un driver deve chiamare la funzione WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT prima di chiamare WdfDmaEnablerConfigureSystemProfile.
A seconda della progettazione di System on a Chip (SoC), il parametro Address potrebbe avere un significato diverso. Ad esempio, se DMA usa porte di trasferimento dedicate nel dispositivo, l'indirizzo potrebbe indicare la porta a cui si verificano le scritture DMA.
Per altre informazioni sulla creazione di un abilitatore DMA in modalità sistema, vedere Supporto di System-Mode DMA.
Esempio
Per un esempio di codice che usa WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, vedere WdfDmaEnablerConfigureSystemProfile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.11 |
| Intestazione | wdfdmaenabler.h (include Wdf.h) |