Función WdfDmaEnablerGetMaximumScatterGatherElements (wdfdmaenabler.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDmaEnablerGetMaximumScatterGatherElements devuelve el número máximo de elementos de dispersión y recopilación que admite el dispositivo y el controlador para un objeto habilitador DMA especificado.

Sintaxis

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Parámetros

[in] DmaEnabler

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

Valor devuelto

Si el controlador llamado anteriormente WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements devuelve el valor especificado en la llamada anterior. De lo contrario, WdfDmaEnablerGetMaximumScatterGatherElements devuelve WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, lo que indica que no hay límite para el número de elementos de dispersión o recopilación.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

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 obtiene el número máximo de elementos de dispersión y recopilación para un objeto habilitador de DMA especificado.

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdmaenabler.h (include Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements