Función NdisIMGetDeviceContext (ndis.h)

  • Artículo

Nota NDIS 5. x ha quedado en desuso y se sustituye por NDIS 6. x. Para el nuevo desarrollo de controladores NDIS, consulte Controladores de red a partir de Windows Vista. Para obtener información sobre cómo migrar NDIS 5. x controladores a NDIS 6. x, consulte Migración de controladores NDIS 5.x a NDIS 6.0.

Esta función permite que una función MiniportInitialize del controlador intermedio NDIS acceda al área de contexto del dispositivo asignada por su función ProtocolBindAdapter .

Sintaxis

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parámetros

[in] MiniportAdapterHandle

Especifica la entrada de identificador en MiniportInitialize.

Valor devuelto

En la tabla siguiente se muestran los valores devueltos para esta función.

Valor Descripción
NDISIMGETDEVICECONTEXT Devuelve el acceso al área de contexto del dispositivo para la NIC virtual identificada por MiniportAdapterHandle.
NULL Si la función ProtocolBindAdapter del controlador no asignó este área de contexto de dispositivo.

Comentarios

Una función MiniportInitialize del controlador intermedio NDIS llama a NdisIMGetDeviceContext para acceder al área de contexto del dispositivo para la NIC virtual que está inicializando. Normalmente, la memoria de este área se proporciona mediante la función ProtocolBindAdapter del controlador intermedio, que llama a NdisIMInitializeDeviceInstanceEx con un puntero a esta área, lo que hace que se llame a la función MiniportInitialize del controlador. Sin embargo, no es necesario que un controlador intermedio tenga un área de contexto de este tipo.

Al volver desde NdisIMGetDeviceContext, MiniportInitialize configura el estado definido por el controlador para la NIC virtual con cualquier información que el escritor de controladores intermedios pretende ser útil para los protocolos de nivel superior que se enlazan posteriormente a su NIC virtual.

Los protocolos NDIS de nivel aún más altos enlazados a la misma NIC virtual posteriormente pueden acceder a este área de contexto de dispositivo llamando a NdisIMGetBindingContext desde sus funciones ProtocolBindAdapter .

Versiones del sistema operativo: Windows CE .NET 4.0 y versiones posteriores.

Requisitos

Requisito Valor
Header ndis.h
Library Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Consulte también