WdfDmaTransactionInitializeUsingOffset-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionInitializeUsingOffset Methode initialisiert eine angegebene DMA-Transaktion mithilfe eines Byte-Offsets in einer MDL-Kette.

Syntax

NTSTATUS WdfDmaTransactionInitializeUsingOffset(
  [in] WDFDMATRANSACTION   DmaTransaction,
  [in] PFN_WDF_PROGRAM_DMA EvtProgramDmaFunction,
  [in] WDF_DMA_DIRECTION   DmaDirection,
  [in] PMDL                Mdl,
  [in] size_t              Offset,
  [in] size_t              Length
);

Die Parameter

[in] DmaTransaction

Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreateabgerufen hat.

[in] EvtProgramDmaFunction

Ein Zeiger auf die EvtProgramDma Ereignisrückruffunktion des Treibers.

[in] DmaDirection

Ein WDF_DMA_DIRECTION-typed-Wert.

[in] Mdl

Ein Zeiger auf eine Speicherdeskriptorliste (MDL), die den Puffer beschreibt, der für die DMA-Transaktion verwendet wird. Weitere Informationen finden Sie in Anmerkungen.

[in] Offset

Der Byte-Offset in der MDL-Kette für die aktuelle Transaktion.

[in] Length

Die Anzahl der zu übertragenden Bytes. Dieser Wert muss größer als null sein.

Rückgabewert

WdfDmaTransactionInitializeUsingOffset gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Methode möglicherweise einen der im Abschnitt "Rückgabewerte" WdfDmaTransactionInitializebeschriebenen Werte zurück.

Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

WdfDmaTransactionInitializeUsingOffset entspricht WdfDmaTransactionInitialize- mit der Ausnahme, dass ein Offset in den durch die MDL-Kette beschriebenen Puffer anstelle einer virtuellen Adresse verwendet wird.

Der Treiber kann eine MDL-Kette im Mdl Parameter dieser Methode angeben. Eine MDL-Kette ist eine Sequenz von MDL-Strukturen, die der Treiber mithilfe des Next Member der MDL-Struktur verkettet hat.

Anforderungen

Siehe auch

WdfDmaTransactionInitialize