funzione WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)

Articolo
2025-03-22

[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 Osservazioni.

[in] DmaWidth

Larghezza del registro specificato da Address.

[in] DmaDescriptor

Il descrittore di risorse tradotte 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 del EvtDevicePrepareHardware funzione di callback. 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, Address potrebbe indicare la porta in cui si verificano le scritture DMA.

Per altre informazioni sulla creazione di un abilitatore DMA in modalità sistema, vedere Supporto System-Mode DMA.

Esempi

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 minima di KMDF	1.11
intestazione	wdfdmaenabler.h (include Wdf.h)

Vedere anche

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreare

Condividi tramite