MINIPORT_WDI_OPEN_ADAPTER função de retorno de chamada (dot11wdi.h)

Artigo
02/06/2025

Importante

Este tópico faz parte do modelo de driver WDI lançado no 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 no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes.

A função de manipulador MiniportWdiOpenAdapter é usada pelo componente da Microsoft para iniciar a operação Abrir Tarefa no driver IHV.

Este é um manipulador de miniporto WDI dentro de NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Essa chamada deve ser concluída rapidamente. Se a operação aberta for iniciada com êxito, o IHV deverá retornar NDIS_STATUS_SUCCESS e chamar o manipulador de OpenAdapterComplete que foi passado para miniportWdiAllocateAdapter com a estrutura NDIS_WDI_INIT_PARAMETERS.

Observação Você deve declarar a função usando o tipo MINIPORT_WDI_OPEN_ADAPTER. Para obter mais informações, consulte a seção Exemplos a seguir.

Sintaxe

MINIPORT_WDI_OPEN_ADAPTER MiniportWdiOpenAdapter;

NDIS_STATUS MiniportWdiOpenAdapter(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_MINIPORT_INIT_PARAMETERS MiniportInitParameters
)
{...}

Parâmetros

[in] MiniportAdapterContext

O identificador para a área de contexto alocada pelo driver de miniporto.

[in] MiniportInitParameters

Um ponteiro para uma estrutura NDIS_MINIPORT_INIT_PARAMETERS que define os parâmetros de inicialização para o adaptador de miniporto.

Valor de retorno

MiniportWdiOpenAdapter pode retornar qualquer um dos seguintes valores retornados.

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	MiniportWdiOpenAdapter foi concluído com êxito.
outros códigos NDIS_STATUS	Um código de NDIS_STATUS apropriado no caso de uma falha.