Función NdisMRegisterWdiMiniportDriver (dot11wdi.h)

Importante

Este tema forma parte del modelo de controlador WDI publicado en Windows 10. El modelo de controlador WDI está en modo de mantenimiento y solo recibirá correcciones de prioridad alta. WiFiCx es el modelo de controlador Wi-Fi publicado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

Un controlador de miniport llama a la función NdisMRegisterWdiMiniportDriver para registrar puntos de entrada MiniportWdiXxx con NDIS como primer paso en la inicialización.

Sintaxis

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

Parámetros

[in] DriverObject

Puntero a un objeto de controlador opaco que el controlador de miniporte recibió en su rutina de DriverEntry en el parámetro Argument1 (vea DriverEntry of NDIS Miniport Drivers).

[in] RegistryPath

Puntero a una ruta de acceso del Registro opaca que el controlador de miniporte recibió en su rutina de DriverEntry en el parámetro Argument2.

[in, optional] NdisDriverContext

Identificador de un área de contexto asignada por el controlador donde el controlador mantiene la información de estado y configuración.

[in] MiniportDriverCharacteristics

Puntero a un NDIS_MINIPORT_DRIVER_CHARACTERISTICS estructura inicializada por el autor de la llamada.

[in] MiniportWdiCharacteristics

Puntero a una estructura NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS inicializada por el autor de la llamada.

[out] NdisMiniportDriverHandle

Puntero a una variable de identificador proporcionada por el autor de la llamada. NDIS escribe un identificador en esta variable que identifica de forma única este controlador. El controlador debe guardar este identificador para usarlo en llamadas de función de Ndis posterioresXxx.

Valor devuelto

NdisMRegisterWdiMiniportDriver puede devolver cualquiera de los siguientes valores devueltos.

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	NdisMRegisterWdiMiniportDriver registró correctamente el controlador de miniport WDI.
NDIS_STATUS_BAD_CHARACTERISTICS	El parámetro CharacteristicsLength es incorrecto para la versión NDIS especificada en el miembro MajorNdisVersion de en la estructura en MiniportDriverCharacteristics .
NDIS_STATUS_BAD_VERSION	El MajorNdisVersion o MinorNdis Version especificado en la estructura de características no es válido.
NDIS_STATUS_RESOURCES	Una escasez de recursos, posiblemente memoria, impedía que NDIS registrara el autor de la llamada.
NDIS_STATUS_FAILURE	Este es un estado de error predeterminado, devuelto cuando ninguno de los errores anteriores provocó un error en el registro.
otros códigos de NDIS_STATUS	Un código NDIS_STATUS adecuado en caso de error.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	dot11wdi.h
biblioteca de	Ndis.lib
irQL	PASSIVE_LEVEL

Consulte también

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS