estrutura NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Artigo
08/07/2023

A estrutura NDIS_SCATTER_GATHER_LIST_PARAMETERS especifica parâmetros que o NDIS usa para criar uma lista de dispersão/coleta para um buffer.

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura (NDIS_SCATTER_GATHER_LIST_PARAMETERS). O driver define o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_DEFAULT, o membro Revision como NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 e o membro Size para NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Reservado para NDIS.

QueueId

Um valor de tipo NDIS_RECEIVE_QUEUE_ID que contém um identificador de fila. O identificador de fila é um inteiro entre zero e o número de filas às quais o adaptador de miniporto dá suporte. Um valor zero indica a fila padrão.

SharedMemoryUsage

Um NDIS_SHARED_MEMORY_USAGE valor de enumeração que especifica a finalidade da memória compartilhada.

Mdl

Um ponteiro para uma MDL (lista de descritores de memória) que descreve o buffer de memória compartilhada.

CurrentVa

Um valor ULONG para o endereço virtual atual.

Length

Um valor ULONG que contém o comprimento, em bytes, do buffer de memória compartilhada.

ProcessSGListHandler

Um ponteiro para uma função NetProcessSGList (NDIS_PROCESS_SG_LIST_HANDLER ponto de entrada).

Context

Um ponteiro para um bloco de informações de contexto alocadas pelo driver que armazena informações sobre a lista de dispersão/coleta. O NDIS passa as informações de contexto em chamadas para NetProcessSGList no parâmetro Context .

ScatterGatherListBuffer

Um ponteiro para uma estrutura SCATTER_GATHER_LIST .

ScatterGatherListBufferSize

Um valor ULONG que contém o comprimento, em bytes, da lista de dispersão/coleta.

ScatterGatherListBufferSizeNeeded

Um valor ULONG em que o NDIS grava o número total de bytes que o NDIS requer para criar a lista de dispersão/coleta com êxito.

Comentários

Para criar uma lista de dispersão/coleta, um driver NDIS passa a estrutura NDIS_SCATTER_GATHER_LIST_PARAMETERS para o Função NdisBuildScatterGatherList .