estructura NDIS_SHARED_MEMORY_PARAMETERS (ndis.h)

Artículo
02/07/2025

La estructura NDIS_SHARED_MEMORY_PARAMETERS especifica los parámetros de memoria compartida para una solicitud de asignación de memoria compartida.

Sintaxis

typedef struct _NDIS_SHARED_MEMORY_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  NDIS_HANDLE              SharedMemoryHandle;
  NODE_REQUIREMENT         PreferredNode;
  NDIS_SHARED_MEMORY_USAGE Usage;
  ULONG                    Length;
  PVOID                    VirtualAddress;
  ULONG                    SGListBufferLength;
  PSCATTER_GATHER_LIST     SGListBuffer;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_SHARED_MEMORY_PARAMETERS, *PNDIS_SHARED_MEMORY_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_SHARED_MEMORY_PARAMETERS. Este miembro tiene el formato de una estructura NDIS_OBJECT_HEADER.

El controlador de miniport debe establecer el miembro Type de Encabezado en NDIS_OBJECT_TYPE_DEFAULT. Para especificar la versión de la estructura de NDIS_SHARED_MEMORY_PARAMETERS, el controlador debe establecer el miembro revisión de de Encabezado en uno de los siguientes valores:

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_2

Se ha agregado VPortId para NDIS 6.30.

Establezca el miembro tamaño de en NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_2.

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_1

Versión original de NDIS 6.20.

Establezca el miembro tamaño de en NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_1.

Flags

Valor UCHAR que contiene un OR bit a bit del siguiente valor:

NDIS_SHARED_MEM_PARAMETERS_CONTIGOUS

La memoria compartida está en un bloque contiguo de memoria.

QueueId

Valor de NDIS_RECEIVE_QUEUE_ID que contiene una cola de máquinas virtuales (VMQ) o virtualización de E/S raíz única (SR-IOV) recibe un identificador de cola. Este identificador es un entero entre cero y el número de colas que admite el adaptador de miniport. Un valor de NDIS_DEFAULT_RECEIVE_QUEUE_ID especifica la cola de recepción predeterminada.

Nota a partir de Windows Server 2012, la interfaz SR-IOV solo admite la cola de recepción predeterminada en puertos virtuales predeterminados y no predeterminados (VPorts). Los controladores de miniportar que admiten la interfaz de SR-IOV deben establecer el miembro queueId de en NDIS_DEFAULT_RECEIVE_QUEUE_ID.

SharedMemoryHandle

Valor de NDIS_HANDLE que identifica un bloque de memoria compartida. NDIS proporciona este identificador antes de volver desde el función NdisAllocateSharedMemory.

PreferredNode

Valor NODE_REQUIREMENT que indica el nodo preferido que se va a usar al asignar memoria. Si el controlador no tiene una preferencia, el valor debe establecerse en MM_ANY_NODE_OK.

Usage

Valor de enumeración NDIS_SHARED_MEMORY_USAGE que especifica el propósito de la memoria compartida.

Length

Valor de ULONG que contiene la longitud, en bytes, del bloque de memoria compartida.

VirtualAddress

Valor PVOID que contiene la dirección virtual base de la memoria compartida. NDIS proporciona este valor antes de que vuelva de la función NdisAllocateSharedMemory.

SGListBufferLength

Valor de ULONG que contiene la longitud, en bytes, del búfer de la lista de recopilación de dispersión.

SGListBuffer

Puntero a una estructura SCATTER_GATHER_LIST.

VPortId

Valor de NDIS_NIC_SWITCH_VPORT_ID que especifica un identificador de puerto virtual (VPort) en el que se va a asignar la memoria compartida. Este valor debe ser el identificador de un VPort no predeterminado que esté asociado a la función física (PF) del adaptador de miniport.

Nota controladores de Miniport que admiten la interfaz VMQ deben establecer este miembro en cero. Los controladores de miniportar que admiten la interfaz de SR-IOV no deben establecer este miembro en cero (NDIS_DEFAULT_VPORT_ID).

Observaciones

La estructura NDIS_SHARED_MEMORY_PARAMETERS especifica los parámetros de memoria compartida para una solicitud de asignación de memoria compartida para una cola de recepción.

Los controladores NDIS pasan esta estructura a la función NdisAllocateSharedMemory y NDIS pasa esta estructura a la función NetAllocateSharedMemory (ALLOCATE_SHARED_MEMORY_HANDLER punto de entrada).