структура NDIS_SCATTER_GATHER_LIST_PARAMETERS (ndis.h)

  • Статья

Структура NDIS_SCATTER_GATHER_LIST_PARAMETERS задает параметры, которые NDIS использует для создания точечных и сборных списков для буфера.

Синтаксис

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;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры (NDIS_SCATTER_GATHER_LIST_PARAMETERS). Драйвер задает для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_DEFAULT, для элемента Revision — NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1, а для элемента Size — NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Зарезервировано для NDIS.

QueueId

Значение типа NDIS_RECEIVE_QUEUE_ID, содержащее идентификатор очереди. Идентификатор очереди — это целое число от нуля до количества очередей, поддерживаемых адаптером мини-порта. Нулевое значение указывает очередь по умолчанию.

SharedMemoryUsage

Значение перечисления NDIS_SHARED_MEMORY_USAGE , указывающее назначение общей памяти.

Mdl

Указатель на список дескрипторов памяти (MDL), описывающий буфер общей памяти.

CurrentVa

Значение ULONG для текущего виртуального адреса.

Length

Значение ULONG, содержащее длину буфера общей памяти в байтах.

ProcessSGListHandler

Указатель на функцию NetProcessSGList (NDIS_PROCESS_SG_LIST_HANDLER точку входа).

Context

Указатель на блок сведений о контексте, выделенном драйвером, в котором хранятся сведения о списке точечной и сборной. NDIS передает сведения о контексте в вызовах NetProcessSGList в параметре Context .

ScatterGatherListBuffer

Указатель на структуру SCATTER_GATHER_LIST .

ScatterGatherListBufferSize

Значение ULONG, содержащее длину (в байтах) точечной или сборной списка.

ScatterGatherListBufferSizeNeeded

Значение ULONG, в котором NDIS записывает общее количество байтов, необходимых NDIS для успешного построения списка точечной и сборной.

Комментарии

Чтобы создать список точечной и сборной, драйвер NDIS передает структуру NDIS_SCATTER_GATHER_LIST_PARAMETERS вФункция NdisBuildScatterGatherList.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.20 и более поздних версиях.
Верхняя часть ndis.h (включая Ndis.h)

См. также раздел

NDIS_OBJECT_HEADER

NDIS_SHARED_MEMORY_USAGE

NdisBuildScatterGatherList

NetProcessSGList

SCATTER_GATHER_LIST