Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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. controladores x a NDIS 6. x, consulte Porting NDIS 5.x Drivers to NDIS 6.0.
Esta función permite que una función MiniportInitialize del controlador intermedio de 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 para 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. |
| NULO | Si la función ProtocolBindAdapter del controlador no asignó este área de contexto de dispositivo. |
Observaciones
Un controlador intermedio NDIS MiniportInitialize llama a la función 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 función 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 de NdisIMGetDeviceContext, MiniportInitialize configura el estado definido por el controlador para la NIC virtual con la 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 del dispositivo llamando a NdisIMGetBindingContext desde sus funciones de ProtocolBindAdapter.
versiones del sistema operativo: Windows CE .NET 4.0 y versiones posteriores.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | ndis.h |
| biblioteca de | Ndis.lib |
| irQL | IRQL <= DISPATCH_LEVEL |