NDIS_SCATTER_GATHER_LIST_PARAMETERS struttura (ndis.h)

Articolo
02/26/2024

La struttura NDIS_SCATTER_GATHER_LIST_PARAMETERS specifica i parametri usati da NDIS per compilare un elenco di dispersione/raccolta per un buffer.

Sintassi

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

Struttura NDIS_OBJECT_HEADER per la struttura (NDIS_SCATTER_GATHER_LIST_PARAMETERS). Il driver imposta il membro Type della struttura che Header specifica per NDIS_OBJECT_TYPE_DEFAULT, il membro Revision su NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1 e il membro Size su NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1.

Flags

Riservato per NDIS.

QueueId

Valore di tipo NDIS_RECEIVE_QUEUE_ID contenente un identificatore della coda. L'identificatore della coda è un numero intero compreso tra zero e il numero di code supportate dall'adattatore miniport. Un valore zero indica la coda predefinita.

SharedMemoryUsage

Valore di enumerazione NDIS_SHARED_MEMORY_USAGE che specifica lo scopo della memoria condivisa.

Mdl

Puntatore a un elenco di descrittori di memoria (MDL) che descrive il buffer di memoria condiviso.

CurrentVa

Valore ULONG per l'indirizzo virtuale corrente.

Length

Valore ULONG che contiene la lunghezza, in byte, del buffer di memoria condivisa.

ProcessSGListHandler

Puntatore a una funzione NetProcessSGList (NDIS_PROCESS_SG_LIST_HANDLER punto di ingresso).

Context

Puntatore a un blocco di informazioni sul contesto allocato dal driver che archivia informazioni sull'elenco di dispersione/raccolta. NDIS passa le informazioni di contesto nelle chiamate a NetProcessSGList nel parametro Context .

ScatterGatherListBuffer

Puntatore a una struttura di SCATTER_GATHER_LIST .

ScatterGatherListBufferSize

Valore ULONG che contiene la lunghezza, in byte, dell'elenco di dispersione/raccolta.

ScatterGatherListBufferSizeNeeded

Valore ULONG in cui NDIS scrive il numero totale di byte che NDIS richiede per compilare correttamente l'elenco di dispersione/raccolta.

Commenti

Per compilare un elenco di dispersione/raccolta, un driver NDIS passa la struttura di NDIS_SCATTER_GATHER_LIST_PARAMETERS all'oggetto Funzione NdisBuildScatterGatherList .