Funzione WdfDmaEnablerGetMaximumScatterGatherElements (wdfdmaenabler.h)
[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) |