estructura NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Artículo
02/26/2024

La estructura NDIS_SCATTER_GATHER_LIST_PARAMETERS especifica los parámetros que usa NDIS para crear una lista de dispersión y recopilación para un búfer.

Sintaxis

typedef struct _NDIS_SCATTER_GATHER_LIST_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_RECEIVE_QUEUE_ID        QueueId;
  NDIS_SHARED_MEMORY_USAGE     SharedMemoryUsage;
  PMDL                         Mdl;
  PVOID                        CurrentVa;
  ULONG                        Length;
  NDIS_PROCESS_SG_LIST_HANDLER ProcessSGListHandler;
  PVOID                        Context;
  PSCATTER_GATHER_LIST         ScatterGatherListBuffer;
  ULONG                        ScatterGatherListBufferSize;
  ULONG                        ScatterGatherListBufferSizeNeeded;
} NDIS_SCATTER_GATHER_LIST_PARAMETERS, *PNDIS_SCATTER_GATHER_LIST_PARAMETERS;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura (NDIS_SCATTER_GATHER_LIST_PARAMETERS). El controlador establece el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision en NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 y el miembro Size en NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Reservado para NDIS.

QueueId

Valor de tipo NDIS_RECEIVE_QUEUE_ID que contiene un identificador de cola. El identificador de cola es un entero entre cero y el número de colas que admite el adaptador de minipuerto. Un valor cero indica la cola predeterminada.

SharedMemoryUsage

Valor de enumeración NDIS_SHARED_MEMORY_USAGE que especifica el propósito de la memoria compartida.

Mdl

Puntero a una lista de descriptores de memoria (MDL) que describe el búfer de memoria compartida.

CurrentVa

Valor de ULONG para la dirección virtual actual.

Length

Valor ULONG que contiene la longitud, en bytes, del búfer de memoria compartida.

ProcessSGListHandler

Puntero a una función NetProcessSGList (NDIS_PROCESS_SG_LIST_HANDLER punto de entrada).

Context

Puntero a un bloque de información de contexto asignada por el controlador que almacena información sobre la lista de dispersión y recopilación. NDIS pasa la información de contexto en llamadas a NetProcessSGList en el parámetro Context .

ScatterGatherListBuffer

Puntero a una estructura de SCATTER_GATHER_LIST .

ScatterGatherListBufferSize

Valor ULONG que contiene la longitud, en bytes, de la lista de dispersión y recopilación.

ScatterGatherListBufferSizeNeeded

Valor de ULONG donde NDIS escribe el número total de bytes que NDIS requiere para compilar correctamente la lista de dispersión y recopilación.

Comentarios

Para crear una lista de dispersión y recopilación, un controlador NDIS pasa la estructura de NDIS_SCATTER_GATHER_LIST_PARAMETERS a la Función NdisBuildScatterGatherList .