estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST (ndischimney.h)

Artigo
08/07/2023

[O recurso de descarregamento de chaminé TCP foi preterido e não deve ser usado.]

A estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST é o bloco de construção básico de uma árvore de estado de descarregamento de chaminé TCP. Uma árvore de estado de descarregamento pode conter uma ou mais estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Sintaxe

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;

Membros

Header

O cabeçalho da estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. O cabeçalho é formatado como uma estrutura NDIS_OBJECT_HEADER . A estrutura NDIS_OBJECT_HEADER contém o número de revisão da estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, o tipo de estado de descarregamento que segue imediatamente a estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na memória e o tamanho da estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, incluindo o cabeçalho, em bytes.

O membro Type da estrutura NDIS_OBJECT_HEADER indica o tipo de estado de descarregamento e, por implicação, a estrutura de estado de descarregamento específica (ou estruturas) que segue imediatamente a estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na memória.

Há suporte para os seguintes valores de OFFLOAD_STATE_TYPE:

NeighborOffloadConstState

Especifica o estado de vizinho constante. Esse estado é formatado como um NEIGHBOR_OFFLOAD_STATE_CONST estrutura.

NeighborOffloadCachedState

Especifica o estado de vizinho armazenado em cache. Esse estado é formatado como um NEIGHBOR_OFFLOAD_STATE_CACHED estrutura.

NeighborOffloadDelegatedState

Especifica o estado do vizinho delegado. Esse estado é formatado como um NEIGHBOR_OFFLOAD_STATE_DELEGATED estrutura.

NeighborOffloadState

Especifica todas as informações de estado do vizinho, incluindo o estado de vizinho constante, armazenado em cache e delegado. Esse estado é formatado como uma estrutura NEIGHBOR_OFFLOAD_STATE_CONST, seguida por uma estrutura NEIGHBOR_OFFLOAD_STATE_CACHED, seguida por uma estrutura NEIGHBOR_OFFLOAD_STATE_DELEGATED.

Ip4OffloadConstState

Especifica o estado do caminho constante (IPv4). Esse estado é formatado como um PATH_OFFLOAD_STATE_CONST estrutura.

Ip4OffloadCachedState

Especifica o estado do caminho armazenado em cache (IPv4). Esse estado é formatado como um PATH_OFFLOAD_STATE_CACHED estrutura.

Ip4OffloadDelegatedState

Especifica o estado do caminho delegado (IPv4). Esse estado é formatado como um PATH_OFFLOAD_STATE_DELEGATED estrutura. Atualmente, não há nenhum estado de caminho delegado. A estrutura PATH_OFFLOAD_STATE_DELEGATED não contém nenhuma variável.

Ip4OffloadState

Especifica todo o estado do caminho (IPv4), incluindo o estado constante, armazenado em cache e caminho delegado. Esse estado é formatado como uma estrutura PATH_OFFLOAD_STATE_CONST, seguida por uma estrutura PATH_OFFLOAD_STATE_CACHED, seguida por uma estrutura PATH_OFFLOAD_STATE_DELEGATED.

Ip6OffloadConstState

Especifica o estado do caminho constante (IPv6). Esse estado é formatado como uma estrutura PATH_OFFLOAD_STATE_CONST.

Ip6OffloadCachedState

Especifica o estado do caminho armazenado em cache (IPv6). Esse estado é formatado como uma estrutura de PATH_OFFLOAD_STATE_CACHED.

Ip6OffloadDelegatedState

Especifica o estado do caminho delegado (IPv6). Esse estado é formatado como uma estrutura PATH_OFFLOAD_STATE_DELEGATED. Atualmente, não há nenhum estado de caminho delegado. A estrutura PATH_OFFLOAD_STATE_DELEGATED não contém nenhuma variável.

Ip6OffloadState

Especifica todas as informações de estado do caminho (IPv6), incluindo o estado constante, armazenado em cache e caminho delegado. Esse estado é formatado como uma estrutura PATH_OFFLOAD_STATE_CONST, seguida por uma estrutura PATH_OFFLOAD_STATE_CACHED, seguida por uma estrutura PATH_OFFLOAD_STATE_DELEGATED.

TcpOffloadConstState

Especifica o estado TCP constante. Esse estado é formatado como um TCP_OFFLOAD_STATE_CONST estrutura.

TcpOffloadCachedState

Especifica o estado TCP armazenado em cache. Esse estado é formatado como um TCP_OFFLOAD_STATE_CACHED estrutura.

TcpOffloadDelegatedState

Especifica o estado TCP delegado. Esse estado é formatado como um TCP_OFFLOAD_STATE_DELEGATED estrutura.

TcpOffloadResourceState

Reservado. Esse valor OFFLOAD_STATE_TYPE, bem como a estrutura TCP_OFFLOAD_RESOURCE_STATE, não são usados no momento.

TcpOffloadState

Especifica todas as informações de estado TCP, incluindo o estado TCP constante, armazenado em cache e delegado. Esse estado é formatado como uma estrutura TCP_OFFLOAD_STATE_CONST, seguida por uma estrutura TCP_OFFLOAD_STATE_CACHED, seguida por uma estrutura TCP_OFFLOAD_STATE_DELEGATED.

FilterReservedOffloadState

Reservado para drivers de filtro.

NextBlock

Um ponteiro para o próximo NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura na camada de estado de descarregamento (vizinho, caminho ou TCP) indicado pelo membro Type do membro Header . NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estruturas vinculadas por meio de ponteiros NextBlock estão sempre na mesma camada do estado de descarregamento. Um valor NextBlock de NULL indica que não há nenhuma estrutura de próximo NDIS_MINIPORT_OFFLOAD_BLOCK_LIST adicional nesse nível.

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

Um ponteiro para uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que está em uma camada dependente do estado de descarregamento (uma camada mais alta na árvore de estado de descarregamento). Para descarregamento de chaminé TCP:

O membro DependentBlockList de uma estrutura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na camada vizinha pode apontar apenas para uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na camada de caminho.
O membro DependentBlockList de uma estrutura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na camada de caminho pode apontar apenas para uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na camada TCP.
O membro DependentBlockList de uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST na camada TCP é sempre NULL.

Um valor DependentBlockList de NULL indica que não há nenhuma estrutura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dependente.

Status

O status de conclusão de uma operação de descarregamento de inicialização, descarregamento de consulta, descarregamento de atualização, descarregamento invalidado ou terminação que o destino de descarregamento executou no estado associado ou referenciado pela estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Dependendo da operação, o destino de descarregamento grava um dos seguintes valores NDIS_STATUS no membro Status :

NDIS_STATUS_SUCCESS

Iniciar descarregamento: o destino de descarregamento descarregou com êxito o estado associado à estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST e ao estado associado a todas as estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST imediatamente dependentes.

Consultar, atualizar, invalidar ou encerrar o descarregamento: o destino de descarregamento executou com êxito a operação no estado associado ou referenciado pela estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

Iniciar descarregamento: o destino de descarregamento descarregou com êxito o estado associado à estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, mas não conseguiu descarregar o estado associado a uma ou mais das estruturas de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST imediatamente dependentes.