WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT-Funktion (wdfdmaenabler.h)

[Gilt nur für KMDF]

Die WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT-Funktion initialisiert die WDF_DMA_SYSTEM_PROFILE_CONFIG-Struktur eines Treibers.

Syntax

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

Parameter

DmaConfig

Ein Zeiger auf eine vom Treiber zugewiesene WDF_DMA_SYSTEM_PROFILE_CONFIG-Struktur .

[in] Address

Die übersetzte Adresse des Registers, das für DMA als Ziel verwendet werden soll. Weitere Informationen finden Sie in den Hinweisen.

[in] DmaWidth

Die Breite des durch Adresse angegebenen Registers.

[in] DmaDescriptor

Der übersetzte Ressourcendeskriptor für den DMA-Kanal, der dem Gerät während evtDevicePrepareHardware zugewiesen wurde.

Rückgabewert

Keine

Bemerkungen

In der Regel ruft ein Treiber WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT aus seiner Rückruffunktion EvtDevicePrepareHardware auf. Ein Treiber muss die funktion WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT aufrufen, bevor WdfDmaEnablerConfigureSystemProfile aufgerufen wird.

Abhängig vom SoC-Design (System on a Chip) kann der Address-Parameter eine andere Bedeutung haben. Wenn DMA beispielsweise dedizierte Übertragungsports auf dem Gerät verwendet, kann Address den Port angeben, an den DMA-Schreibvorgänge erfolgen.

Weitere Informationen zum Erstellen eines DMA-Enablers im Systemmodus finden Sie unter Unterstützen System-Mode DMA.

Beispiele

Ein Codebeispiel, das WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT verwendet, finden Sie unter WdfDmaEnablerConfigureSystemProfile.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Zielplattform	Universell
KMDF-Mindestversion	1.11
Kopfzeile	wdfdmaenabler.h (einschließen von Wdf.h)

Weitere Informationen

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerErstellen