Función NdisBuildScatterGatherList (ndis.h)

Artículo
08/07/2023

La función NdisBuildScatterGatherList crea una lista de dispersión y recopilación mediante los parámetros especificados.

Sintaxis

NDIS_STATUS NdisBuildScatterGatherList(
  [in] IN NDIS_HANDLE                          NdisHandle,
  [in] IN PNDIS_SCATTER_GATHER_LIST_PARAMETERS SGListParameters
);

Parámetros

[in] NdisHandle

Controlador o controlador NDIS que se obtuvo durante la inicialización del autor de la llamada. Por ejemplo, un controlador de minipuerto puede usar el identificador NDIS que obtuvo del Función NdisMRegisterMiniportDriver o MiniportInitializeEx . Otros controladores NDIS pueden usar los identificadores de las siguientes funciones:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

[in] SGListParameters

Puntero a un NDIS_SCATTER_GATHER_LIST_PARAMETERS estructura que especifica los parámetros para asignar la lista de dispersión y recopilación.

Valor devuelto

NdisBuildScatterGatherList puede devolver los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	La operación se ha completado correctamente.
NDIS_STATUS_BUFFER_TOO_SHORT	Error en la operación porque la longitud del búfer especificada en el miembro ScatterGatherListBufferSize del NDIS_SCATTER_GATHER_LIST_PARAMETERS estructura era demasiado corta. En este caso, NDIS proporcionó el tamaño de búfer necesario en el miembro ScatterGatherListBufferSizeNeeded .

Comentarios

Los controladores NDIS llaman a la función NdisBuildScatterGatherList para crear una lista de dispersión y recopilación para un búfer. Para llamar a esta función, un controlador de minipuerto especifica un controlador de adaptador de minipuerto o un controlador de protocolo especifica un identificador de enlace NDIS.

El adaptador de minipuerto subyacente debe haber llamado NdisMRegisterScatterGatherDma antes de que un controlador pueda llamar a NdisBuildScatterGatherList.

NDIS llama a la función NetProcessSGList que se especifica en el miembro ProcessSGListHandler del NDIS_SCATTER_GATHER_LIST_PARAMETERS estructura en el contexto de NdisBuildScatterGatherList.

Los controladores deben llamar a Función NdisFreeScatterGatherList para liberar una lista de dispersión y recopilación que se creó con la Función NdisBuildScatterGatherList .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con NDIS 6.20 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	= DISPATCH_LEVEL