estrutura NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

Artigo
02/07/2025

A estrutura de 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 tipo da estrutura que de Cabeçalho especifica para NDIS_OBJECT_TYPE_DEFAULT, o membro de Revisão para NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 e o membro tamanho do 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 que o adaptador de miniporto dá suporte. Um valor zero indica a fila padrão.

SharedMemoryUsage

Um valor de enumeração NDIS_SHARED_MEMORY_USAGE 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 compartilhado.

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 compartilhado.

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.

Observações

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