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 enabler 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 WdfDmaEnablerCrea.
Valore restituito
Se il driver precedentemente chiamato 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.
Osservazioni:
Per altre informazioni su questo metodo, vedere Abilitazione delle transazioni DMA.
Esempi
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 minima di KMDF | 1.0 |
| intestazione | wdfdmaenabler.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <=DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |