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)

Vedi anche

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements