EVT_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL Rückruffunktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die Ereignisrückruffunktion EvtDmaTransactionConfigureDmaChannel eines Treibers konfiguriert den DMA-Adapter für einen DMA-Enabler im Systemmodus.

Syntax

EVT_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL EvtWdfDmaTransactionConfigureDmaChannel;

BOOLEAN EvtWdfDmaTransactionConfigureDmaChannel(
  [in]           WDFDMATRANSACTION DmaTransaction,
  [in]           WDFDEVICE Device,
  [in]           PVOID Context,
  [in, optional] PMDL Mdl,
  [in]           size_t Offset,
  [in]           size_t Length
)
{...}

Parameter

[in] DmaTransaction

Ein Handle für ein DMA-Transaktionsobjekt, das die ausgeführte Transaktion darstellt.

[in] Device

Ein Handle für das Framework-Geräteobjekt, das der Treiber beim Aufrufen von WdfDmaTransactionCreate angegeben hat.

[in] Context

Der Kontextzeiger, den der Treiber in einem vorherigen Aufruf von WdfDmaTransactionSetChannelConfigurationCallback angegeben hat.

[in, optional] Mdl

Ein Zeiger auf eine einzelne Speicherdeskriptorliste (MDL) oder MDL-Kette, die den der aktuellen Übertragung zugeordneten Puffer beschreibt, oder NULL, wenn die letzte Übertragung abgeschlossen wurde und der Adapter freigegeben wird.

[in] Offset

Ein Byteoffset in den Puffer, der im Mdl-Parameter angegeben ist, in dem die aktuelle Übertragung beginnt.

[in] Length

Die Anzahl der Bytes, die in der aktuellen Übertragung übertragen werden.

Rückgabewert

Die Rückruffunktion EvtDmaTransactionConfigureDmaChannel gibt TRUE zurück, wenn sie den DMA-Kanal erfolgreich konfiguriert. Wenn diese Rückruffunktion FALSE zurückgibt, beendet das Framework die Transaktion und ruft EvtProgramDma nicht auf.

Hinweise

Treiber registrieren eine EvtDmaTransactionConfigureDmaChannel-Ereignisrückruffunktion , indem sie WdfDmaTransactionSetChannelConfigurationCallback aufrufen.

Das Framework ruft EvtDmaTransactionConfigureDmaChannel einmal für jede DMA-Übertragung des Systemprofils in der Transaktion auf, nachdem der Adapterkanal zugewiesen wurde, aber vor der Zuordnung der Übertragung und dem Aufruf von EvtProgramDma.

Der Treiber kann den EvtDmaTransactionConfigureDmaChannel-Rückruf verwenden, um eine beliebige benutzerdefinierte Programmierung für den DMA-Adapter festzulegen, bevor eine Übertragung zugeordnet wird.

Wenn beim Konfigurieren des Kanals ein Fehler auftritt, kann er die DMA-Übertragung beenden, indem WdfDmaTransactionDmaCompletedFinal aufgerufen und ggf. die Anforderung abgeschlossen wird. Der Treiber sollte dann FALSE von dieser Rückruffunktion zurückgeben.

Anforderungen

Weitere Informationen

WdfDmaTransactionDmaCompletedFinal

WdfDmaTransactionSetChannelConfigurationCallback