Función WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)

  • Artículo

[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 de habilitador DMA especificado.

Sintaxis

void WdfDmaEnablerSetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler,
  [in] size_t        MaximumFragments
);

Parámetros

[in] DmaEnabler

Identificador de un objeto de habilitador DMA que el controlador obtuvo de una llamada anterior a WdfDmaEnablerCreate.

[in] MaximumFragments

Número máximo de elementos de dispersión o recopilación que el controlador y el dispositivo pueden admitir.

Valor devuelto

None

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 EvtDriverDeviceAdd 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 o recopilación.

Para obtener más información sobre este método, consulte 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 de DMA especificado.

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdmaenabler.h (incluya Wdf.h)
Library 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)

Consulte también

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements