Função WdfDmaTransactionDmaCompletedWithLength (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionDmaCompletedWithLength notifica a estrutura de que a operação de transferência de DMA de um dispositivo está concluída e fornece o comprimento da transferência concluída.

Sintaxe

BOOLEAN WdfDmaTransactionDmaCompletedWithLength(
  [in]  WDFDMATRANSACTION DmaTransaction,
  [in]  size_t            TransferredLength,
  [out] NTSTATUS          *Status
);

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA que o driver obteve de uma chamada anterior para WdfDmaTransactionCreate.

[in] TransferredLength

O número de bytes transferidos pelo dispositivo na transferência de DMA atual.

[out] Status

Um ponteiro para um local que recebe o status da transferência de DMA. Para obter mais informações, consulte a seção Comentários para WdfDmaTransactionDmaCompleted.

Retornar valor

WdfDmaTransactionDmaCompletedWithLength retorna FALSE e Status recebe STATUS_MORE_PROCESSING_REQUIRED se forem necessárias transferências adicionais para concluir a transação de DMA. O método retornará TRUE se nenhuma transferência adicional for necessária.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Quando o driver chama o método WdfDmaTransactionDmaCompletedWithLength , a estrutura encerra a transferência atual e, se necessário, inicia uma nova.

O método WdfDmaTransactionDmaCompletedWithLength se comporta da mesma forma que WdfDmaTransactionDmaCompleted, exceto que os drivers chamam WdfDmaTransactionDmaCompletedWithLength para dispositivos que relatam o número de bytes transferidos. A estrutura usa a contagem de bytes relatada para determinar o início da próxima transferência de DMA para a transação de DMA especificada, se várias transferências forem necessárias para concluir a transação.

Para obter mais informações sobre como concluir transferências de DMA, consulte Concluindo uma transferência de DMA.

Exemplos

O exemplo de código a seguir é do driver de exemplo PLX9x5x . Este exemplo chama WdfDmaTransactionGetCurrentDmaTransferLength para determinar o comprimento original da transferência atual e, em seguida, calcula o comprimento real da transferência. Em seguida, o exemplo chama WdfDmaTransactionDmaCompletedWithLength para relatar o comprimento real da transferência para a estrutura. Se a transferência atual for a última para a transação, o exemplo chamará uma rotina privada que conclui a solicitação de E/S.

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
                           );
}

Requisitos

Confira também

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfDmaTransactionGetCurrentDmaTransferLength