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 de Wi-Fi publicado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes.

Un controlador de minipuerto 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 minipuerto recibió en su rutina DriverEntry en el parámetro Argument1 (consulte 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 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 que inicializó 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 su uso en llamadas de función NdisXxx posteriores.

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 la estructura en MiniportDriverCharacteristics .
NDIS_STATUS_BAD_VERSION
MajorNdisVersion o MinorNdisVersion especificado en la estructura de características no es válido.
NDIS_STATUS_RESOURCES
Una escasez de recursos, posiblemente memoria, impidió que NDIS registrara el autor de la llamada.
NDIS_STATUS_FAILURE
Se trata de 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 de NDIS_STATUS adecuado en caso de error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Encabezado dot11wdi.h
Library Ndis.lib
IRQL PASSIVE_LEVEL

Consulte también

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS