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

Artigo
02/23/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.

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

Esse é um manipulador de miniporte 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 OpenAdapterComplete que foi passado para MiniportWdiAllocateAdapter com a estrutura NDIS_WDI_INIT_PARAMETERS .

Nota 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.

Retornar valor

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.