OPEN_NDK_ADAPTER_HANDLER função de retorno de chamada (ndisndk.h)

Artigo
02/26/2024

A função OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) abre uma instância do adaptador NDK em um adaptador de miniporto NDIS compatível com NDK.

Sintaxe

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

Parâmetros

[in] MiniportAdapterContext

Um identificador para uma área de contexto que o driver de miniporto alocou em sua função MiniportInitializeEx . O driver de miniporta usa essa área de contexto para manter informações de estado para um adaptador de miniporto NDIS.

[in] Parameters

Um ponteiro para uma estrutura NDIS_OPEN_NDK_ADAPTER_PARAMETERS que define os parâmetros de entrada para abrir uma instância de NDK_ADAPTER .

A estrutura NDIS_OPEN_NDK_ADAPTER_PARAMETERS deve especificar a versão principal do NDKPI e a versão secundária do NDKPI mais baixa à qual o consumidor do NDK pode dar suporte.

Se o provedor não der suporte à versão principal especificada pelo consumidor, o provedor deverá falhar na solicitação com NDIS_STATUS_BAD_VERSION.

Se o provedor der suporte à versão principal especificada pelo consumidor e a versão secundária especificada for menor ou igual à versão secundária mais alta compatível com o provedor, o provedor deverá ter êxito na solicitação e usar a versão secundária mais alta à qual o provedor dá suporte.

Por exemplo, se o consumidor solicitar a versão 1.0 e o provedor der suporte a 1.1, o provedor deverá relatar a versão 1.1 na estrutura NDK_ADAPTER_INFO e cabeçalhos de objeto NDK.

Nota Versões secundárias mais altas no provedor são sempre totalmente compatíveis com versões secundárias (ou seja, um superconjunto de) versões secundárias inferiores.

Se o provedor der suporte à versão principal especificada pelo consumidor e a versão secundária especificada for maior que a versão secundária mais alta compatível com o provedor, o provedor deverá falhar na solicitação com NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Um ponteiro para uma variável que contém o ponteiro para uma estrutura NDK_ADAPTER . No retorno de OPEN_NDK_ADAPTER_HANDLER, a estrutura de NDK_ADAPTER referenciada por ppNdkAdapter identifica a instância do adaptador NDK recém-aberta.

Retornar valor

OPEN_NDK_ADAPTER_HANDLER pode retornar um dos seguintes valores:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A instância do adaptador NDK foi aberta com êxito.
NDIS_STATUS_BAD_VERSION	Não há suporte para o número de versão solicitado.
NDIS_STATUS_ADAPTER_NOT_READY	A funcionalidade NDK do adaptador de miniporto não está habilitada.
NDIS_STATUS_RESOURCES	O NDIS não pôde abrir o adaptador NDK devido a recursos insuficientes.

Comentários

OPEN_NDK_ADAPTER_HANDLER abre uma instância NDK_ADAPTER em um adaptador de miniporte NDIS compatível com NDK. Várias instâncias NDK_ADAPTER podem ser criadas no mesmo adaptador de miniporto NDIS. Cada instância NDK_ADAPTER contém um ponteiro para uma tabela de funções de expedição que implementam a interface de programação de aplicativo NDK. O driver de miniporta chama a função CLOSE_NDK_ADAPTER_HANDLER para fechar a instância do adaptador NDK e liberar os recursos associados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum com suporte, com suporte no NDIS 6.30 e posterior.
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	ndisndk.h
IRQL	PASSIVE_LEVEL