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