Función NdisMGetOffloadHandlers (ndischimney.h)

Artículo
08/07/2023

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

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.

Todos 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 la chimenea que contiene los puntos de entrada. La estructura de NDIS_OFFLOAD_EVENT_HANDLERS tiene el siguiente formato:

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, cuyo formato es una estructura de 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.

Comentarios

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 de NDIS_OBJECT_HEADER . El destino de descarga examina los miembros Type, Revision y Size de la estructura NDIS_OBJECT_HEADER. Estos miembros especifican la estructura que contiene los puntos de entrada específicos de la chimenea, el número de revisión de esta estructura y el tamaño de esta estructura en bytes. El valor Type 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 revisión especificado, convierte el puntero OffloadHandlers a un puntero al tipo de estructura específico de chimenea adecuado. En la tabla siguiente se indica la estructura específica de la chimenea para cada tipo de chimenea.

ChimneyType	Estructura de controladores específicos de la chimenea
NdisTcpChimneyOffload	NDIS_TCP_OFFLOAD_EVENT_HANDLERS

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

La estructura de controladores específicos de la chimenea contiene la misma estructura de 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.