Funzione WdfDmaEnablerGetMaximumScatterGatherElements (wdfdmaenabler.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfDmaEnablerGetMaximumScatterGatherElements restituisce il numero massimo di elementi a dispersione/raccolta supportati dal dispositivo e dal driver per un oggetto abilitatore DMA specificato.

Sintassi

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Parametri

[in] DmaEnabler

Handle per un oggetto enabler DMA ottenuto dal driver da una chiamata precedente a WdfDmaEnablerCreate.

Valore restituito

Se il driver precedentemente denominato WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements restituisce il valore specificato dal driver nella chiamata precedente. In caso contrario, WdfDmaEnablerGetMaximumScatterGatherElements restituisce WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, che indica che non esiste alcun limite al numero di elementi a dispersione/raccolta.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Per altre informazioni su questo metodo, vedere Abilitazione delle transazioni DMA.

Esempio

Nell'esempio di codice seguente viene ottenuto il numero massimo di elementi scatter/gather per un oggetto enabler DMA specificato.

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfdmaenabler.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)

Vedi anche

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements