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)

Vedi anche

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate