Funzione WdfDmaTransactionSetSingleTransferRequirement (wdfdmatransaction.h)

[Si applica solo a KMDF]

Il metodo WdfDmaTransactionSetSingleTransferRequirement specifica che una transazione DMA deve essere completata in un singolo trasferimento.

Sintassi

void WdfDmaTransactionSetSingleTransferRequirement(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] BOOLEAN           RequireSingleTransfer
);

Parametri

[in] DmaTransaction

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

[in] RequireSingleTransfer

Valore booleano che, se TRUE, specifica che la transazione DMA richiede un singolo trasferimento.

Valore restituito

nessuno

Osservazioni

Questo metodo richiede un singolo trasferimento solo per una singola transazione. Quando l'oggetto transazione viene riciclato con WdfDmaTransactionRelease e reinizializzato, questa impostazione viene reimpostata, analogamente ad altre proprietà a livello di transazione, ad esempio l'esecuzione immediata e la lunghezza massima del trasferimento.

Per richiedere il trasferimento singolo per tutte le transazioni DMA create con un abilitatore DMA specificato, specificare WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER in WDF_DMA_ENABLER_CONFIG_FLAGS quando si chiama WdfDmaEnablerCreate. Equivale a chiamare WdfDmaTransactionSetSingleTransferRequirement per ogni oggetto transazione creato con l'abilitazione DMA.

Il driver chiama WdfDmaTransactionSetSingleTransferRequirement dopo aver creato o riciclato l'oggetto transazione, ma prima di inizializzarlo o eseguirlo. Per altre informazioni, vedere Uso di DMA trasferimento singolo.

WdfDmaTransactionSetSingleTransferRequirement richiede DMA versione 3. Per selezionare DMA versione 3, impostare il membro WdmDmaVersionOverride di WDF_DMA_ENABLER_CONFIG su 3.

Requisiti

Vedi anche

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest