SerCx2SystemDmaReceiveGetDmaEnabler-Funktion (sercx.h)
Die SerCx2SystemDmaReceiveGetDmaEnabler Methode ruft den DMA-Enabler für den System-DMA-Controller ab, der für System-DMA-Empfangstransaktionen verwendet wird.
Syntax
WDFDMAENABLER SerCx2SystemDmaReceiveGetDmaEnabler(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);
Parameter
[in] SystemDmaReceive
Ein SERCX2SYSTEMDMARECEIVE Handle für ein System-DMA-Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2SystemDmaReceiveCreate Methode aufgerufen, um dieses Objekt zu erstellen.
Rückgabewert
Diese Methode gibt ein WDFDMAENABLER-Handle an das Framework-DMA-Enabler-Objekt zurück, das den System-DMA-Controller darstellt, der für System-DMA-Empfangstransaktionen verwendet wird.
Bemerkungen
Bei Bedarf kann ihr serieller Controllertreiber diese Methode aufrufen, um spezielle Features im DMA-Controller des Systems zu konfigurieren. Der Treiber kann die von dieser Methode zurückgegebene DMA-Aktivierung verwenden, um DMA-Einstellungen anzugeben, die in der SERCX2_SYSTEM_DMA_RECEIVE_CONFIG Struktur nicht angegeben wurden, die der Treiber zuvor als Eingabeparameter an die SerCx2SystemDmaReceiveCreate-Methode übergeben hat. Oder der Treiber kann den DMA-Enabler verwenden, um die DMA-Einstellungen zu ändern, die zuvor in dieser Struktur angegeben wurden.
Weitere Informationen zu DMA-Aktivierungsobjekten finden Sie unter Aktivieren von DMA-Transaktionen. Weitere Informationen zu System-DMA-Receive-Transaktionen finden Sie unter SerCx2 System-DMA-Receive Transactions.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Verfügbar ab Windows 8.1. |
Zielplattform- | Universal |
Header- | sercx.h |
IRQL- | <= DISPATCH_LEVEL |