Função NdisMRegisterWdiMiniportDriver (dot11wdi.h)

Artigo
02/26/2024

Importante

Este tópico faz parte do modelo de driver WDI lançado em Windows 10. O modelo de driver WDI está no modo de manutenção e receberá apenas correções de alta prioridade. WiFiCx é o modelo de driver Wi-Fi lançado em Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

Um driver de miniporto chama a função NdisMRegisterWdiMiniportDriver para registrar pontos de entrada miniportWdiXxx com NDIS como a primeira etapa na inicialização.

Sintaxe

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

Um ponteiro para um objeto de driver opaco que o driver de miniporto recebeu em sua rotina DriverEntry no parâmetro Argument1 (consulte DriverEntry of NDIS Miniport Drivers).

[in] RegistryPath

Um ponteiro para um caminho de registro opaco que o driver de miniporto recebeu em sua rotina DriverEntry no parâmetro Argument2 .

[in, optional] NdisDriverContext

Um identificador para uma área de contexto alocada por driver em que o driver mantém informações de estado e configuração.

[in] MiniportDriverCharacteristics

Um ponteiro para um NDIS_MINIPORT_DRIVER_CHARACTERISTICS estrutura que o chamador inicializou.

[in] MiniportWdiCharacteristics

Um ponteiro para uma estrutura NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS que o chamador inicializou.

[out] NdisMiniportDriverHandle

Um ponteiro para uma variável de identificador fornecida pelo chamador. O NDIS grava um identificador nessa variável que identifica exclusivamente esse driver. O driver deve salvar esse identificador para uso em chamadas de função NdisXxx subsequentes.

Retornar valor

NdisMRegisterWdiMiniportDriver pode retornar qualquer um dos valores retornados a seguir.

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	NdisMRegisterWdiMiniportDriver registrou o driver de miniporto WDI com êxito.
NDIS_STATUS_BAD_CHARACTERISTICS	O parâmetro CharacteristicsLength está incorreto para a versão do NDIS especificada no membro MajorNdisVersion na estrutura em MiniportDriverCharacteristics .
NDIS_STATUS_BAD_VERSION	O MajorNdisVersion ou MinorNdisVersion especificado na estrutura de características é inválido.
NDIS_STATUS_RESOURCES	Uma escassez de recursos, possivelmente memória, impediu que o NDIS registrasse o chamador.
NDIS_STATUS_FAILURE	Esse é um erro padrão status, retornado quando nenhum dos erros anteriores causou falha no registro.
Outros códigos de NDIS_STATUS	Um código de NDIS_STATUS apropriado no caso de uma falha.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10
Servidor mínimo com suporte	Windows Server 2016
Plataforma de Destino	Windows
Cabeçalho	dot11wdi.h
Biblioteca	Ndis.lib
IRQL	PASSIVE_LEVEL

Confira também

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

Compartilhar via