Função NdisMOffloadEventIndicate (ndischimney.h)

Artigo
08/07/2023

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

Um destino de descarregamento chama a função NdisMOffloadEventIndicate para indicar vários eventos para a pilha de host.

Sintaxe

void NdisMOffloadEventIndicate(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList,
  [in] IN ULONG                             IndicationCode
);

Parâmetros

[in] NdisMiniportHandle

O identificador que o destino de descarregamento obteve em uma chamada anterior para NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Um ponteiro para um NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura. Essa estrutura identifica o objeto de estado descarregado no qual a indicação está sendo feita. Observe que há apenas uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Não há uma lista vinculada dessas estruturas.

O destino de descarregamento fornece um ponteiro OffloadBlockList válido ao fazer uma indicação NeighborReachabilityQuery . Nesse caso, o destino de descarregamento fornece um NEIGHBOR_OFFLOAD_STATE_CONST estrutura, um NEIGHBOR_OFFLOAD_STATE_CACHED estrutura e um NEIGHBOR_OFFLOAD_STATE_DELEGATED estrutura (nessa ordem) imediatamente após a estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST referenciada pelo ponteiro OffloadBlockList .

Um destino de descarregamento deve inicializar os seguintes membros de uma estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que ele passa para a função NdisMOffloadEventIndicate :

Todos os membros da estrutura NDIS_OBJECT_HEADER, incluindo Tipo, Revisão e Tamanho . O destino de descarregamento deve inicializar Tipo para NeighborOffloadState.
O ponteiro NextBlock para um valor não NULL se houver um próximo bloco; caso contrário, para NULL.
O ponteiro DependentBlockList para NULL.
O membro Status a ser NDIS_STATUS_SUCCESS.

O destino de descarregamento não precisa inicializar nenhum outro membro da estrutura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Para todas as indicações que não sejam a indicação NeighborReachabilityQuery , o destino de descarregamento fornece um ponteiro OffloadBlockList que é NULL.

[in] IndicationCode

O evento que está sendo indicado é especificado como um dos seguintes valores de INDICATE_OFFLOAD_EVENT:

NeighborReachabilityQuery

Indica que uma NCE (entrada de cache) vizinha ficou obsoleta. Para obter mais informações sobre NCEs, consulte RFC 2461.

NeighborReachabilityInDoubt

Reservado.

Retornar valor

Nenhum

Comentários

A pilha de host usa a indicação NeighborReachabilityQuery para detectar a inacessibilidade do vizinho para IPv4 e IPv6. Para obter uma descrição detalhada dessa indicação, consulte Making a NeighborReachabilityQuery Indication.