estructura NDK_SGE (ndkpi.h)

Artículo
08/07/2023

La estructura NDK_SGE especifica los búferes locales para las solicitudes de trabajo de NDK.

Sintaxis

typedef struct _NDK_SGE {
  union {
    PVOID               VirtualAddress;
    NDK_LOGICAL_ADDRESS LogicalAddress;
  };
  ULONG  Length;
  UINT32 MemoryRegionToken;
} NDK_SGE;

Miembros

VirtualAddress

Una dirección virtual.

LogicalAddress

Una dirección lógica.

Length

Longitud, en bytes, del búfer.

MemoryRegionToken

Token de región de memoria. Cuando MemoryRegionToken se establece en el token devuelto por NdkGetPrivilegedMemoryRegionToken (NDK_FN_GET_PRIVILEGED_MEMORY_REGION_TOKEN), el NDK_SGE debe contener logicalAddress. Cuando MemoryRegionToken no es igual al token devuelto por NdkGetPrivilegedMemoryRegionToken, la estructura de NDK_SGE debe contener una VirtualAddress. Cuando se usa una estructura de NDK_SGE en una solicitud de trabajo con la marca NDK_OP_FLAG_INLINE , MemoryRegionToken podría no ser válido. Consulte la sección comentarios para obtener más información sobre MemoryRegionToken.

Comentarios

La estructura NDK_SGE especifica los búferes locales para las solicitudes de trabajo de envío, recepción, lectura y escritura.

Cuando el miembro MemoryRegionToken se establece en el token devuelto por NdkGetPrivilegedMemoryRegionToken (NDK_FN_GET_PRIVILEGED_MEMORY_REGION_TOKEN), el NDK_SGE debe contener una dirección lógica devuelta por la función NdkBuildLam (NDK_FN_BUILD_LAM) con la estructura NDK_LOGICAL_ADDRESS_MAPPING . Tenga en cuenta que las entradas consecutivas del miembro AdapterPageArray de un NDK_LOGICAL_ADDRESS_MAPPING no son necesariamente páginas contiguas en el espacio de direcciones lógicas del adaptador. Por lo tanto, un consumidor de NDK podría usar varias SGE para cubrir todas las páginas de una matriz de páginas del adaptador.

Cuando el token del miembro MemoryRegionToken no es igual al token devuelto por NdkGetPrivilegedMemoryRegionToken, la estructura NDK_SGE debe contener una dirección virtual que se encuentre dentro del intervalo de direcciones virtuales de una región de memoria registrada anteriormente.

Cuando se usa una estructura de NDK_SGE en una solicitud de trabajo con la marca NDK_OP_FLAG_INLINE , el token de MemoryRegionToken podría no ser válido, por lo que el proveedor de NDK debe omitirlo. Cuando se especifica la marca NDK_OP_FLAG_INLINE , el miembro VirtualAddress de cualquier estructura de NDK_SGE que se pasa a la función de solicitud de trabajo debe apuntar a un búfer al que pueda tener acceso el proveedor de NDK en un IRQL menor o igual que DISPATCH_LEVEL, es decir, se debe garantizar que el búfer resida en memoria física hasta que la función de solicitud de trabajo devuelva. El tamaño total de los datos insertados que se pasan al proveedor en una sola llamada no debe superar el valor del parámetro InlineDataSize que se especificó cuando se creó el par de colas (QP).

Requisitos

Requisito	Value
Cliente mínimo compatible	Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible	Windows Server 2012
Encabezado	ndkpi.h (incluya Ndkpi.h)