Função NdisMOffloadEventIndicate (ndischimney.h)

Artigo
02/07/2025

[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 de OffloadBlockList válido ao fazer uma indicação de 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 de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST referenciada pelo ponteiro OffloadBlockList.

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

Todos os membros da estrutura NDIS_OBJECT_HEADER, incluindo Type, Revisione Size . O destino de descarregamento deve inicializar type para NeighborOffloadState.
O ponteiro NextBlock para um valor deNULL não se houver um próximo bloco; caso contrário, para NULL.
O ponteiro DependentBlockList para NULL .
O membro status do 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 diferentes da 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 entrada de cache vizinha (NCE) ficou obsoleta. Para obter mais informações sobre NCEs, consulte RFC 2461.

NeighborReachabilityInDoubt

Reservado.

Valor de retorno

Nenhum

Observações

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.