Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Si applica solo a KMDF]
Il metodo WdfDmaEnablerSetMaximumScatterGatherElements imposta il numero massimo di elementi a dispersione/raccolta supportati da un dispositivo per un oggetto enabler DMA specificato.
Sintassi
void WdfDmaEnablerSetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler,
[in] size_t MaximumFragments
);
Parametri
[in] DmaEnabler
Handle per un oggetto enabler DMA ottenuto dal driver da una chiamata precedente a WdfDmaEnablerCrea.
[in] MaximumFragments
Numero massimo di elementi a dispersione/raccolta supportati dal driver e dal dispositivo.
Valore restituito
Nessuno
Osservazioni:
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Se il driver chiama WdfDmaEnablerSetMaximumScatterGatherElements, deve farlo all'interno della EvtDriverDeviceAdd o EvtDevicePrepareHardware funzione di callback.
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 a dispersione/raccolta.
Per altre informazioni su questo metodo, vedere Abilitazione delle transazioni DMA.
Esempi
Nell'esempio di codice seguente viene impostato il numero massimo di elementi scatter/gather per un oggetto enabler DMA specificato.
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
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 | PASSIVE_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |