NDIS_SCATTER_GATHER_LIST_PARAMETERS structure (ndis.h)
The NDIS_SCATTER_GATHER_LIST_PARAMETERS structure specifies parameters that NDIS uses to build a scatter/gather list for a buffer.
Syntax
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;
Members
Header
The NDIS_OBJECT_HEADER structure for the structure (NDIS_SCATTER_GATHER_LIST_PARAMETERS). The driver sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 and the Size member to NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.
Flags
Reserved for NDIS.
QueueId
An NDIS_RECEIVE_QUEUE_ID type value that contains a queue identifier. The queue identifier is an integer between zero and the number of queues that the miniport adapter supports. A zero value indicates the default queue.
SharedMemoryUsage
An NDIS_SHARED_MEMORY_USAGE enumeration value that specifies the purpose of the shared memory.
Mdl
A pointer to a memory descriptor list (MDL) that describes the shared memory buffer.
CurrentVa
A ULONG value for the current virtual address.
Length
A ULONG value that contains the length, in bytes, of the shared memory buffer.
ProcessSGListHandler
A pointer to a NetProcessSGList function (NDIS_PROCESS_SG_LIST_HANDLER entry point).
Context
A pointer to a block of driver-allocated context information that stores information about the scatter/gather list. NDIS passes the context information in calls to NetProcessSGList at the Context parameter.
ScatterGatherListBuffer
A pointer to a SCATTER_GATHER_LIST structure.
ScatterGatherListBufferSize
A ULONG value that contains the length, in bytes, of the scatter/gather list.
ScatterGatherListBufferSizeNeeded
A ULONG value where NDIS writes the total number of bytes that NDIS requires to build the scatter/gather list successfully.
Remarks
To build a scatter/gather list, an NDIS driver passes the NDIS_SCATTER_GATHER_LIST_PARAMETERS structure to the NdisBuildScatterGatherList function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.20 and later. |
| Header | ndis.h (include Ndis.h) |