Macro NdisMInitializeWrapper (ndis.h)

2025-02-07

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.

NdisMInitializeWrapper notifica a NDIS que se inicializa 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 de del controlador de miniporte DriverEntry.

[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 miniporte.

[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

Ninguno

Observaciones

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

Estas llamadas posteriores de un controlador a NdisXxx funciones de inicialización y configuración deben pasar la 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 NdisMInitializeWrapper devuelve. Si el valor es NULL, el controlador debe producir un error en la llamada a la función DriverEntry.