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
);
Die Parameter
DmaConfig
Ein Zeiger auf eine vom Treiber zugewiesene WDF_DMA_SYSTEM_PROFILE_CONFIG Struktur.
[in] Address
Die übersetzte Adresse des Registers für DMA. Weitere Informationen finden Sie in den Hinweisen.
[in] DmaWidth
Die Breite des registers, das durch Addressangegeben wird.
[in] DmaDescriptor
Der übersetzte Ressourcendeskriptor für den DMA-Kanal hat dem Gerät während EvtDevicePrepareHardwarezugewiesen.
Rückgabewert
Nichts
Bemerkungen
In der Regel ruft ein Treiber WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT innerhalb seiner EvtDevicePrepareHardware Rückruffunktion auf. Ein Treiber muss die WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT-Funktion aufrufen, bevor WdfDmaEnablerConfigureSystemProfileaufgerufen wird.
Je nach System auf einem Chip -Design (SoC) kann der Address Parameter eine andere Bedeutung haben. Wenn DMA beispielsweise dedizierte Übertragungsports auf dem Gerät verwendet, kann Address den Port angeben, in den DMA-Schreibvorgänge auftreten.
Weitere Informationen zum Erstellen einer DMA-Aktivierung im Systemmodus finden Sie unter Unterstützen von System-Mode DMA-.
Beispiele
Ein Codebeispiel, das WDF_DMA_SYSTEM_PROFILE_CONFIG_INITverwendet, finden Sie unter WdfDmaEnablerConfigureSystemProfile.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützter Client (Mindestversion) | Windows 8 |
| Zielplattform | universell |
| Minimale KMDF-Version | 1.11 |
| Kopfzeile | wdfdmaenabler.h (include Wdf.h) |