SerCx2SystemDmaTransmitGetDmaEnabler-Funktion (sercx.h)

Artikel
02/26/2024

Die SerCx2SystemDmaTransmitGetDmaEnabler-Methode ruft den DMA-Enabler für den DMA-Systemcontroller ab, der für System-DMA-Übertragungstransaktionen verwendet wird.

Syntax

WDFDMAENABLER SerCx2SystemDmaTransmitGetDmaEnabler(
  [in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit
);

Parameter

[in] SystemDmaTransmit

Ein SERCX2SYSTEMDMATRANSMIT Handle für ein DMA-Übertragungsobjekt. Der serielle Controllertreiber hat zuvor die SerCx2SystemDmaTransmitCreate-Methode aufgerufen, um dieses Objekt zu erstellen.

Rückgabewert

Diese Methode gibt ein WDFDMAENABLER-Handle an das DMA-Enabler-Objekt des Frameworks zurück, das den DMA-Systemcontroller darstellt, der für System-DMA-Übertragungstransaktionen verwendet wird.

Hinweise

Bei Bedarf kann Ihr serieller Controllertreiber diese Methode aufrufen, um spezielle Features im DMA-Controller des Systems zu konfigurieren. Der Treiber kann den von dieser Methode zurückgegebenen DMA-Enabler verwenden, um DMA-Einstellungen anzugeben, die nicht in der SERCX2_SYSTEM_DMA_TRANSMIT_CONFIG-Struktur angegeben wurden, die der Treiber zuvor als Eingabeparameter an die SerCx2SystemDmaTransmitCreate-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-Enabler-Objekten finden Sie unter Aktivieren von DMA-Transaktionen. Weitere Informationen zu System-DMA-Transmit-Transaktionen finden Sie unter SerCx2 System-DMA-Transmit Transactions.