Macro NdisMInitializeWrapper (ndis.h)

Artículo
03/10/2023

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.

NdisMInitializeWrapper notifica a NDIS que se está inicializando un nuevo controlador de miniport.

Sintaxis

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Parámetros

[out] _a

Puntero a una variable proporcionada por el autor de la llamada en la que NDIS devuelve un identificador que se representa a sí mismo. Si se produce un error en la llamada a NdisMInitializeWrapper , NDIS establece la variable en NdisWrapperHandle en NULL.

[in] _b

Especifica un puntero de un tipo específico del sistema.

Para los controladores de Windows 2000 y versiones posteriores, se trata de un puntero a una entrada de objeto de controlador opaco a la función DriverEntry del controlador de miniport.

[in] _c

Especifica un puntero de un tipo específico del sistema.

Para los controladores de Windows 2000 y versiones posteriores, se trata de un puntero a una entrada de ruta de acceso del Registro opaca a la función DriverEntry del controlador de miniport.

[in] _d

Especifica un puntero de un tipo específico del sistema.

Para los controladores de Windows 2000 y versiones posteriores, este puntero debe establecerse en NULL cuando el controlador de miniporte llama a NdisMInitializeWrapper.

Valor devuelto

None

Observaciones

Un controlador NIC o controlador intermedio debe llamar a NdisMInitializeWrapper antes de llamar a cualquier otra función NdisXxx. Normalmente, esta llamada es la acción inicial de cualquier función DriverEntry del controlador NIC, que llama a NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con el NdisWrapperHandle devuelto a continuación. Los controladores intermedios NDIS también deben llamar a NdisMInitializeWrapper desde la función DriverEntry y, a continuación, llamar a NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con el NdisWrapperHandle devuelto.

Estas llamadas posteriores de un controlador a las funciones de inicialización y configuración de NdisXxx deben pasar NdisWrapperHandle como parámetro. Por lo tanto, es un parámetro de entrada para la función MiniportInitialize .

Si se produce un error en la llamada a NdisMInitializeWrapper , NDIS establece la variable en NdisWrapperHandle en NULL. El controlador siempre debe comprobar el valor de esta variable después de que se devuelva NdisMInitializeWrapper . Si el valor es NULL, el controlador debe producir un error en la llamada a la función DriverEntry .