Funzione WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)
[Si applica solo a KMDF]
Il metodo WdfDmaEnablerSetMaximumScatterGatherElements imposta il numero massimo di elementi di dispersione/raccolta supportati da un dispositivo per un oggetto abilitatore DMA specificato.
Sintassi
void WdfDmaEnablerSetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler,
[in] size_t MaximumFragments
);
Parametri
[in] DmaEnabler
Handle a un oggetto abilitante DMA ottenuto dal driver da una chiamata precedente a WdfDmaEnablerCreate.
[in] MaximumFragments
Numero massimo di elementi a dispersione/raccolta supportati dal driver e dal dispositivo.
Valore restituito
nessuno
Osservazioni
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Se il driver chiama WdfDmaEnablerSetMaximumScatterGatherElements, deve farlo all'interno della funzione di callback EvtDriverDeviceAdd o EvtDevicePrepareHardware.
Se il driver non chiama WdfDmaEnablerSetMaximumScatterGatherElements, il framework usa un valore predefinito di WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, il che significa che non esiste alcun limite al numero di elementi di dispersione/raccolta.
Per altre informazioni su questo metodo, vedere Abilitazione delle transazioni DMA.
Esempio
Nell'esempio di codice seguente viene impostato il numero massimo di elementi di dispersione/raccolta per un oggetto abilitatore DMA specificato.
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfdmaenabler.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |