Função NdisMGetOffloadHandlers (ndischimney.h)

Artigo
08/07/2023

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

Essa função obtém os pontos de entrada das funções NDIS para um tipo de chaminé específico.

Sintaxe

NDIS_STATUS NdisMGetOffloadHandlers(
  [in]  IN NDIS_HANDLE                   NdisMiniportHandle,
  [in]  IN NDIS_CHIMNEY_OFFLOAD_TYPE     ChimneyType,
  [out] OUT PNDIS_OFFLOAD_EVENT_HANDLERS *OffloadHandlers
);

Parâmetros

[in] NdisMiniportHandle

O identificador para uma área de contexto alocada pelo destino de descarregamento na qual o destino de descarregamento mantém informações de estado sobre essa instância do adaptador. O destino de descarregamento forneceu esse identificador para o NDIS ao chamar NdisMSetMiniportAttributes de sua Função MiniportInitializeEx .

[in] ChimneyType

Um tipo de chaminé que é um dos seguintes valores de NDIS_CHIMNEY_OFFLOAD_TYPE:

NdisTcpChimneyOffload

O tipo de descarregamento de chaminé TCP.

Todos os outros valores NDIS_CHIMNEY_OFFLOAD_TYPE estão reservados no momento.

[out] OffloadHandlers

Um ponteiro para uma variável fornecida pelo destino de descarregamento. O tamanho dessa variável é sizeof(PNDIS_OFFLOAD_EVENT_HANDLERS). Se a chamada para a função NdisMGetOffloadHandlers for bem-sucedida, a função retornará, nesta variável, um ponteiro para uma estrutura NDIS_OFFLOAD_EVENT_HANDLERS. Essa estrutura serve como um cabeçalho para a estrutura específica da chaminé que contém os pontos de entrada. A estrutura NDIS_OFFLOAD_EVENT_HANDLERS é formatada da seguinte maneira:

typedef struct _NDIS_OFFLOAD_EVENT_HANDLERS {
  NDIS_OBJECT_HEADER  Header;
} NDIS_OFFLOAD_EVENT_HANDLERS, *PNDIS_OFFLOAD_EVENT_HANDLERS;

Essa estrutura contém o seguinte membro:

Especifica um cabeçalho de objeto NDIS, que é formatado como uma estrutura NDIS_OBJECT_HEADER .

Retornar valor

NdisMGetOffloadHandlers pode retornar um dos seguintes:

Código de retorno	Descrição
STATUS_SUCCESS	A chamada foi bem-sucedida. Os pontos de entrada NDIS retornados são válidos para o tipo de chaminé especificado.
STATUS_NOT_SUPPORTED	O NDIS não dá suporte ao tipo de chaminé especificado pelo destino de descarregamento. Nesse caso, o NDIS não retorna um ponteiro OffloadHandlers válido.

Comentários

O destino de descarregamento chama essa função de sua função MiniportInitializeEx para obter os pontos de entrada das funções NDIS para um tipo de chaminé específico. O destino de descarregamento chama NdisMGetOffloadHandlers uma vez para cada tipo de chaminé compatível. Em cada chamada, o destino de descarregamento especifica um tipo de chaminé diferente.

Se a chamada para a função NdisMGetOffloadHandlers for bem-sucedida, o NDIS fornecerá um ponteiro OffloadHandlers válido, que aponta para uma estrutura NDIS_OFFLOAD_EVENT_HANDLERS. Essa estrutura contém uma estrutura NDIS_OBJECT_HEADER . O destino de descarregamento examina os membros Tipo, Revisão e Tamanho da estrutura NDIS_OBJECT_HEADER. Esses membros especificam a estrutura que contém os pontos de entrada específicos da chaminé, o número de revisão dessa estrutura e o tamanho dessa estrutura em bytes. O valor Type é o mesmo valor que o destino de descarregamento fornecido para o parâmetro ChimneyType .

Se o destino de descarregamento der suporte ao número de revisão especificado, ele converterá o ponteiro OffloadHandlers em um ponteiro para o tipo de estrutura específico da chaminé apropriado. A tabela a seguir indica a estrutura específica da chaminé para cada tipo de chaminé.

ChimneyType	Estrutura de manipuladores específicos da chaminé
NdisTcpChimneyOffload	NDIS_TCP_OFFLOAD_EVENT_HANDLERS

Por exemplo, para o tipo de chaminé NdisTcpChimneyOffload , o destino de descarregamento converte o ponteiro OffloadHandlers em *PNDIS_TCP_OFFLOAD_EVENT_HANDLERS.

A estrutura de manipuladores específicos da chaminé contém a mesma estrutura NDIS_OBJECT_HEADER que a estrutura NDIS_OFFLOAD_EVENT_HANDLERS.

O destino de descarregamento copia os pontos de entrada da estrutura específica da chaminé para sua própria estrutura de dados interna e retorna.