Función NdisMGetOffloadHandlers (ndischimney.h)

Artículo
02/07/2025

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

Esta función obtiene los puntos de entrada de las funciones NDIS para un tipo de chimenea determinado.

Sintaxis

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

Identificador de un área de contexto que está asignada por el destino de descarga en la que el destino de descarga mantiene información de estado sobre esta instancia del adaptador. El destino de descarga proporcionó este identificador a NDIS al llamar a NdisMSetMiniportAttributes de su función miniportInitializeEx.

[in] ChimneyType

Tipo de chimenea que es uno de los siguientes valores de NDIS_CHIMNEY_OFFLOAD_TYPE:

NdisTcpChimneyOffload

Tipo de descarga de chimenea TCP.

Los demás valores de NDIS_CHIMNEY_OFFLOAD_TYPE están reservados actualmente.

[out] OffloadHandlers

Puntero a una variable proporcionada por el destino de descarga. El tamaño de esta variable es sizeof(PNDIS_OFFLOAD_EVENT_HANDLERS). Si la llamada a la función NdisMGetOffloadHandlers se realiza correctamente, la función devuelve, en esta variable, un puntero a una estructura NDIS_OFFLOAD_EVENT_HANDLERS. Esta estructura actúa como encabezado para la estructura específica de chimenea que contiene los puntos de entrada. La estructura NDIS_OFFLOAD_EVENT_HANDLERS tiene el formato siguiente:

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

Esta estructura contiene el siguiente miembro:

Especifica un encabezado de objeto NDIS, que tiene el formato de estructura NDIS_OBJECT_HEADER.

Valor devuelto

NdisMGetOffloadHandlers puede devolver cualquiera de las siguientes opciones:

Código devuelto	Descripción
STATUS_SUCCESS	La llamada se realizó correctamente. Los puntos de entrada NDIS devueltos son válidos para el tipo de chimenea especificado.
STATUS_NOT_SUPPORTED	NDIS no admite el tipo de chimenea especificado por el destino de descarga. En este caso, NDIS no devuelve un puntero OffloadHandlers válido.

Observaciones

El destino de descarga llama a esta función desde su función MiniportInitializeEx para obtener los puntos de entrada de las funciones NDIS para un tipo de chimenea determinado. El destino de descarga llama a NdisMGetOffloadHandlers una vez para cada tipo de chimenea que admita. En cada llamada, el destino de descarga especifica un tipo de chimenea diferente.

Si la llamada a la función NdisMGetOffloadHandlers se realiza correctamente, NDIS proporciona un puntero OffloadHandlers válido, que apunta a una estructura de NDIS_OFFLOAD_EVENT_HANDLERS. Esta estructura contiene una estructura NDIS_OBJECT_HEADER. El destino de descarga examina los miembros de Type, Revisiony Size de la estructura NDIS_OBJECT_HEADER. Estos miembros especifican la estructura que contiene los puntos de entrada específicos de chimenea, el número de revisión de esta estructura y el tamaño de esta estructura en bytes. El valor type de es el mismo valor que el destino de descarga proporcionado para el parámetro ChimneyType.

Si el destino de descarga admite el número de de revisión de especificado, convierte el OffloadHandlers puntero a un puntero al tipo de estructura específico de chimenea adecuado. En la tabla siguiente se indica la estructura específica de chimenea para cada tipo de chimenea.

chimneyType	Estructura de controladores específicos de Chimenea
NdisTcpChimneyOffload	NDIS_TCP_OFFLOAD_EVENT_HANDLERS

Por ejemplo, para el tipo de chimenea NdisTcpChimneyOffload, el destino de descarga convierte el OffloadHandlers puntero a *PNDIS_TCP_OFFLOAD_EVENT_HANDLERS.

La estructura de controladores específicos de chimenea contiene la misma estructura NDIS_OBJECT_HEADER que la estructura NDIS_OFFLOAD_EVENT_HANDLERS.

El destino de descarga copia los puntos de entrada de la estructura específica de la chimenea en su propia estructura de datos interna y, a continuación, devuelve.