SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT_NEW_DATA_NOTIFICATION-Funktion (sercx.h)

Artikel
02/26/2024

Die SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT_NEW_DATA_NOTIFICATION-Funktion initialisiert eine SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur .

Syntax

void SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT_NEW_DATA_NOTIFICATION(
  [out] SERCX2_SYSTEM_DMA_RECEIVE_CONFIG                           *Config,
  [in]  size_t                                                     MaximumTransferLength,
  [in]  PHYSICAL_ADDRESS                                           Address,
  [in]  DMA_WIDTH                                                  DmaWidth,
  [in]  PCM_PARTIAL_RESOURCE_DESCRIPTOR                            DmaDescriptor,
  [in]  PFN_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION EvtSerCx2SystemDmaReceiveEnableNewDataNotification,
  [in]  PFN_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION EvtSerCx2SystemDmaReceiveCancelNewDataNotification
);

Parameter

[out] Config

Ein Zeiger auf die SERCX2_SYSTEM_DMA_RECEIVE_CONFIG Struktur, die initialisiert werden soll.

[in] MaximumTransferLength

Der Wert, der in das MaximumTransferLength-Element der SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung des MaximumTransferLength-Elements in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

[in] Address

Der Wert, der in den DeviceAddress-Member der SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung dieses Members in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

[in] DmaWidth

Der Wert, der in das DmaWidth-Element der SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung dieses Members in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

[in] DmaDescriptor

Der Wert, der in den DmaDescriptor-Member der SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung dieses Members in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

[in] EvtSerCx2SystemDmaReceiveEnableNewDataNotification

Der Wert, der in den EvtSerCx2SystemDmaReceiveEnableNewDataNotification-Member der SERCX2_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung dieses Members in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

[in] EvtSerCx2SystemDmaReceiveCancelNewDataNotification

Der Wert, der in das EvtSerCx2SystemDmaReceiveCancelNewDataNotification-Element der SERCX2_CONFIG-Struktur geladen werden soll. Weitere Informationen finden Sie in der Beschreibung dieses Members in SERCX2_SYSTEM_DMA_RECEIVE_CONFIG.

Rückgabewert

Keine

Bemerkungen

Ihr serieller Controllertreiber muss entweder diese Funktion oder die SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT-Funktion verwenden, um eine SERCX2_SYSTEM_DMA_RECEIVE_CONFIG-Struktur zu initialisieren, bevor ein Zeiger auf diese Struktur als Eingabeparameter an die SerCx2SystemDmaReceiveCreate-Methode übergeben wird.

SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT_NEW_DATA_NOTIFICATION legt den Size-Member der -Struktur auf sizeof(SERCX2_SYSTEM_DMA_RECEIVE_CONFIG) fest und legt sechs zusätzliche Member der -Struktur auf die Werte fest, die als Eingabeparameter für die Funktion bereitgestellt werden. Die -Funktion legt die anderen Member der -Struktur auf 0 (null) fest. Der Treiber kann diese anderen Member nach dem Aufruf des SERCX2_SYSTEM_DMA_RECEIVE_CONFIG_INIT_NEW_DATA_NOTIFICATION bei Bedarf explizit auf Werte ungleich null festlegen.