Funzione WdfDmaTransactionDmaCompletedWithLength (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionDmaCompletedWithLength notifica al framework che l'operazione di trasferimento DMA di un dispositivo è stata completata e fornisce la lunghezza del trasferimento completato.
Sintassi
BOOLEAN WdfDmaTransactionDmaCompletedWithLength(
[in] WDFDMATRANSACTION DmaTransaction,
[in] size_t TransferredLength,
[out] NTSTATUS *Status
);
Parametri
[in] DmaTransaction
Handle per un oggetto transazione DMA ottenuto dal driver da una chiamata precedente a WdfDmaTransactionCreate.
[in] TransferredLength
Numero di byte trasferiti dal dispositivo nel trasferimento DMA corrente.
[out] Status
Puntatore a una posizione che riceve lo stato del trasferimento DMA. Per altre informazioni, vedere la sezione Osservazioni per WdfDmaTransactionDmaCompleted.
Valore restituito
WdfDmaTransactionDmaCompletedWithLength restituisce FALSE e Status riceve STATUS_MORE_PROCESSING_REQUIRED se sono necessari trasferimenti aggiuntivi per completare la transazione DMA. Il metodo restituisce TRUE se non sono necessari trasferimenti aggiuntivi.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Commenti
Quando il driver chiama il metodo WdfDmaTransactionDmaCompletedWithLength , il framework termina il trasferimento corrente e, se necessario, avvia un nuovo metodo.
Il metodo WdfDmaTransactionDmaCompletedWithLength si comporta come WdfDmaTransactionDmaCompleted, ad eccezione del fatto che i driver chiamano WdfDmaTransactionDmaCompletedWithLength per i dispositivi che segnalano il numero di byte trasferiti. Il framework usa il conteggio dei byte segnalato per determinare l'inizio del successivo trasferimento DMA per la transazione DMA specificata, se sono necessari più trasferimenti per completare la transazione.
Per altre informazioni sul completamento dei trasferimenti DMA, vedere Completamento di un trasferimento DMA.
Esempio
L'esempio di codice seguente è tratto dal driver di esempio PLX9x5x5x . Questo esempio chiama WdfDmaTransactionGetCurrentDmaTransferLength per determinare la lunghezza originale del trasferimento corrente e quindi calcola la lunghezza effettiva del trasferimento. L'esempio chiama quindi WdfDmaTransactionDmaCompletedWithLength per segnalare la lunghezza effettiva del trasferimento al framework. Se il trasferimento corrente è l'ultimo per la transazione, nell'esempio viene chiamata una routine privata che completa la richiesta di I/O.
BOOLEAN hasTransitioned;
PDMA_TRANSFER_ELEMENT dteVA;
ULONG length;
//
// Use "DMA Clear-Count Mode" to get the complementary
// transferred byte count.
//
length = WdfDmaTransactionGetCurrentDmaTransferLength(dmaTransaction);
dteVA = (PDMA_TRANSFER_ELEMENT) devExt->ReadCommonBufferBase;
while(dteVA->DescPtr.LastElement == FALSE) {
length -= dteVA->TransferSize;
dteVA++;
}
length -= dteVA->TransferSize;
//
// Indicate that this DMA operation has completed.
//
hasTransitioned =
WdfDmaTransactionDmaCompletedWithLength(
dmaTransaction,
length,
&status
);
if (hasTransitioned) {
//
// Complete this DMA transaction.
//
devExt->CurrentReadDmaTransaction = NULL;
PLxReadRequestComplete(
dmaTransaction,
status
);
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |