Función WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)
[Solo se aplica a KMDF]
El método WdfDmaEnablerSetMaximumScatterGatherElements establece el número máximo de elementos de dispersión y recopilación que admite un dispositivo para un objeto habilitador DMA especificado.
Sintaxis
void WdfDmaEnablerSetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler,
[in] size_t MaximumFragments
);
Parámetros
[in] DmaEnabler
Identificador de un objeto enabler DMA que el controlador obtuvo de una llamada anterior a WdfDmaEnablerCreate.
[in] MaximumFragments
El número máximo de elementos de dispersión y recopilación que el controlador y el dispositivo pueden admitir.
Valor devuelto
Ninguno
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Si el controlador llama a WdfDmaEnablerSetMaximumScatterGatherElements, debe hacerlo dentro de la función de devolución de llamada EvtDriverDeviceAd d o EvtDevicePrepareHardware.
Si el controlador no llama a WdfDmaEnablerSetMaximumScatterGatherElements, el marco usa un valor predeterminado de WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, lo que significa que no hay ningún límite para el número de elementos de dispersión y recopilación.
Para obtener más información sobre este método, vea Habilitación de transacciones DMA.
Ejemplos
En el ejemplo de código siguiente se establece el número máximo de elementos de dispersión y recopilación para un objeto de habilitador DMA especificado.
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado | wdfdmaenabler.h (incluya Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |