estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST (ndischimney.h)

Artículo
08/07/2023

[La característica de descarga de chimenea TCP está en desuso y no debe usarse].

La estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST es el bloque de creación básico de un árbol de estado de descarga de chimenea TCP. Un árbol de estado de descarga puede contener una o varias estructuras de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Sintaxis

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  IN PVOID                             ProtocolReserved[2];
  IN PVOID                             MiniportReserved[2];
  IN PVOID                             ImReserved[2];
  IN PVOID                             Scratch[2];
  IN PVOID                             SourceHandle;
  IN NDIS_PORT_NUMBER                  PortNumber;
  IN OUT PNET_BUFFER_LIST              NetBufferListChain;
} NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

Miembros

Header

Encabezado de la estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. El encabezado tiene el formato de estructura NDIS_OBJECT_HEADER. La estructura NDIS_OBJECT_HEADER contiene el número de revisión de la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, el tipo de estado de descarga que sigue inmediatamente la estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en memoria y el tamaño de la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, incluido el encabezado, en bytes.

El tipo miembro de la estructura de NDIS_OBJECT_HEADER indica el tipo de estado de descarga e implicación, la estructura de estado de descarga específica (o estructuras) que siguen inmediatamente la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en memoria.

Se admiten los siguientes valores de OFFLOAD_STATE_TYPE:

NeighborOffloadConstState

Especifica el estado de vecino constante. Este estado tiene el formato estructura NEIGHBOR_OFFLOAD_STATE_CONST.

NeighborOffloadCachedState

Especifica el estado vecino almacenado en caché. Este estado tiene el formato NEIGHBOR_OFFLOAD_STATE_CACHED estructura.

NeighborOffloadDelegatedState

Especifica el estado vecino delegado. Este estado tiene el formato NEIGHBOR_OFFLOAD_STATE_DELEGATED estructura.

NeighborOffloadState

Especifica toda la información de estado vecino, incluida la constante, almacenada en caché y el estado vecino delegado. Este estado tiene el formato de una estructura NEIGHBOR_OFFLOAD_STATE_CONST, seguida de una estructura NEIGHBOR_OFFLOAD_STATE_CACHED, seguida de una estructura de NEIGHBOR_OFFLOAD_STATE_DELEGATED.

Ip4OffloadConstState

Especifica el estado de ruta de acceso constante (IPv4). Este estado tiene el formato PATH_OFFLOAD_STATE_CONST estructura.

Ip4OffloadCachedState

Especifica el estado de la ruta de acceso almacenada en caché (IPv4). Este estado tiene el formato PATH_OFFLOAD_STATE_CACHED estructura.

Ip4OffloadDelegatedState

Especifica el estado de ruta de acceso delegada (IPv4). Este estado tiene el formato estructura PATH_OFFLOAD_STATE_DELEGATED. Actualmente no hay ningún estado de ruta de acceso delegado. La estructura PATH_OFFLOAD_STATE_DELEGATED no contiene ninguna variable.

Ip4OffloadState

Especifica todo el estado de la ruta de acceso (IPv4), incluido el estado constante, almacenado en caché y ruta de acceso delegada. Este estado tiene el formato de una estructura PATH_OFFLOAD_STATE_CONST, seguida de una estructura PATH_OFFLOAD_STATE_CACHED, seguida de una estructura PATH_OFFLOAD_STATE_DELEGATED.

Ip6OffloadConstState

Especifica el estado de la ruta de acceso constante (IPv6). Este estado tiene el formato de estructura PATH_OFFLOAD_STATE_CONST.

Ip6OffloadCachedState

Especifica el estado de la ruta de acceso almacenada en caché (IPv6). Este estado tiene el formato de estructura PATH_OFFLOAD_STATE_CACHED.

Ip6OffloadDelegatedState

Especifica el estado de ruta de acceso delegada (IPv6). Este estado tiene el formato de estructura PATH_OFFLOAD_STATE_DELEGATED. Actualmente, no hay ningún estado de ruta de acceso delegado. La estructura PATH_OFFLOAD_STATE_DELEGATED no contiene ninguna variable.

Ip6OffloadState

Especifica toda la información de estado de la ruta de acceso (IPv6), incluido el estado constante, almacenado en caché y ruta de acceso delegada. Este estado tiene el formato de una estructura PATH_OFFLOAD_STATE_CONST, seguida de una estructura PATH_OFFLOAD_STATE_CACHED, seguida de una estructura PATH_OFFLOAD_STATE_DELEGATED.

TcpOffloadConstState

Especifica el estado TCP constante. Este estado tiene el formato estructura TCP_OFFLOAD_STATE_CONST.

TcpOffloadCachedState

Especifica el estado TCP almacenado en caché. Este estado tiene el formato TCP_OFFLOAD_STATE_CACHED estructura.

TcpOffloadDelegatedState

Especifica el estado TCP delegado. Este estado tiene el formato TCP_OFFLOAD_STATE_DELEGATED estructura.

TcpOffloadResourceState

Reservado. Este valor OFFLOAD_STATE_TYPE, así como la estructura TCP_OFFLOAD_RESOURCE_STATE, no se usan actualmente.

TcpOffloadState

Especifica toda la información de estado TCP, incluida la constante, la caché y el estado TCP delegado. Este estado tiene el formato de estructura TCP_OFFLOAD_STATE_CONST, seguido de una estructura de TCP_OFFLOAD_STATE_CACHED, seguida de una estructura de TCP_OFFLOAD_STATE_DELEGATED.

FilterReservedOffloadState

Reservado para controladores de filtro.

NextBlock

Puntero a la siguiente estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa de estado de descarga (vecino, ruta de acceso o TCP) indicada por el miembro Type del miembro Encabezado. NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructuras vinculadas a través de punteros de NextBlock siempre están en la misma capa del estado de descarga. Un valor NextBlock de NULL indica que no hay ninguna estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST adicional en este nivel.

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

Puntero a una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que se encuentra en una capa dependiente del estado de descarga (una capa superior en el árbol de estado de descarga). Para la descarga de chimenea TCP:

El miembro DependentBlockList de una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa vecina solo puede apuntar a una estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa de ruta de acceso.
El miembro DependentBlockList de una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa de ruta de acceso solo puede apuntar a una estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa TCP.
El miembro DependentBlockList de una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en la capa TCP siempre es NULL.

Un DependentBlockList valor de NULL indica que no hay ninguna estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dependiente.

Status

Estado de finalización de una operación de descarga de inicio, descarga de consulta, descarga de actualización, invalidar la descarga o finalizar la operación de descarga que el destino de descarga realizó en el estado asociado o al que hace referencia la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. En función de la operación, el destino de descarga escribe uno de los siguientes valores de NDIS_STATUS en el miembro Estado de:

NDIS_STATUS_SUCCESS

Iniciar la descarga: el destino de descarga descargaba correctamente el estado asociado a la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST y el estado asociado a todas las estructuras de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dependientes inmediatamente.

Consulta, actualización, invalidar o finalizar la descarga: el destino de descarga realizó correctamente la operación en el estado asociado o al que hace referencia la estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

Iniciar descarga: el destino de descarga ha descargado correctamente el estado asociado a la estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, pero no pudo descargar el estado asociado a una o varias de las estructuras de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dependientes inmediatamente.