Condividi tramite


Funzione WdfDmaTransactionRelease (wdfdmatransaction.h)

[Si applica solo a KMDF]

Il metodo WdfDmaTransactionRelease termina una transazione DMA specificata senza eliminare l'oggetto transazione DMA associato.

Sintassi

NTSTATUS WdfDmaTransactionRelease(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parametri

[in] DmaTransaction

Handle a un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.

Valore restituito

WdfDmaTransactionRelease restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire il valore seguente:

Codice restituito Descrizione
STATUS_INVALID_DEVICE_STATE
Il driver ha già rilasciato o eliminato l'oggetto transazione specificato dal parametro DmaTransaction .
 

Questo metodo potrebbe restituire anche altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Il metodo WdfDmaTransactionRelease scarica i buffer di trasferimento e rilascia tutte le risorse di sistema associate alla transazione DMA. L'oggetto transazione non viene eliminato e può essere riutilizzato. Per altre informazioni sul riutilizzo degli oggetti transazioni, vedere Riutilizzo di oggetti transazioni DMA.

Se WdfDmaTransactionInitializeXxx restituisce esito positivo ma WdfDmaTransactionExecute restituisce un valore di errore, il driver deve chiamare WdfDmaTransactionRelease.

Esempio

L'esempio di codice seguente termina la transazione DMA rappresentata dall'oggetto transazione DMA specificato, ma non elimina l'oggetto transazione DMA.

NTSTATUS  status;

status = WdfDmaTransactionRelease(dmaTransaction);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfdmatransaction.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfDmaTransactionCreate