OPEN_NDK_ADAPTER_HANDLER funzione di callback (ndisndk.h)

Articolo
02/27/2024

La funzione OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) apre un'istanza della scheda NDK in una scheda miniport con supporto per NDK.

Sintassi

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

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

Parametri

[in] MiniportAdapterContext

Handle in un'area di contesto allocata dal driver miniport nella funzione MiniportInitializeEx . Il driver miniport usa questa area di contesto per mantenere le informazioni sullo stato per un adattatore miniport NDIS.

[in] Parameters

Puntatore a una struttura NDIS_OPEN_NDK_ADAPTER_PARAMETERS che definisce i parametri di input per aprire un'istanza NDK_ADAPTER.

La struttura NDIS_OPEN_NDK_ADAPTER_PARAMETERS deve specificare la versione principale NDKPI e la versione secondaria NDKPI più bassa che il consumer NDK può supportare.

Se il provider non supporta la versione principale specificata dal consumer, il provider deve non riuscire la richiesta con NDIS_STATUS_BAD_VERSION.

Se il provider supporta la versione principale specificata dal consumer e la versione secondaria specificata è minore o uguale alla versione secondaria più alta supportata dal provider, il provider deve eseguire la richiesta e usare la versione secondaria più alta supportata dal provider.

Ad esempio, se il consumer richiede la versione 1.0 e il provider supporta 1.1, il provider deve segnalare la versione 1.1 nella struttura NDK_ADAPTER_INFO e nelle intestazioni dell'oggetto NDK.

Nota Le versioni secondarie più elevate del provider sono sempre completamente compatibili con le versioni precedenti, ovvero un superset di versioni secondarie.

Se il provider supporta la versione principale specificata dal consumer e la versione secondaria specificata è maggiore della versione secondaria più alta supportata dal provider, il provider deve non riuscire la richiesta con NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Puntatore a una variabile che contiene il puntatore a una struttura NDK_ADAPTER . In caso di ritorno da OPEN_NDK_ADAPTER_HANDLER, la struttura NDK_ADAPTER a cui fa riferimento ppNdkAdapter identifica l'istanza dell'adattatore NDK appena aperta.

Valore restituito

OPEN_NDK_ADAPTER_HANDLER può restituire uno dei valori seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	L'istanza della scheda NDK è stata aperta correttamente.
NDIS_STATUS_BAD_VERSION	Il numero di versione richiesto non è supportato.
NDIS_STATUS_ADAPTER_NOT_READY	La funzionalità NDK dell'adattatore miniport non è abilitata.
NDIS_STATUS_RESOURCES	NDIS non è stato in grado di aprire l'adattatore NDK a causa di risorse insufficienti.

Commenti

OPEN_NDK_ADAPTER_HANDLER apre un'istanza NDK_ADAPTER in una scheda miniport con supporto per NDIS NDK. È possibile creare più istanze NDK_ADAPTER nella stessa scheda miniport NDIS. Ogni NDK_ADAPTER istanza contiene un puntatore a una tabella di funzioni di invio che implementano l'interfaccia di programmazione dell'applicazione NDK. Il driver miniport chiama la funzione CLOSE_NDK_ADAPTER_HANDLER per chiudere l'istanza della scheda NDK e rilasciare le risorse associate.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndisndk.h
IRQL	PASSIVE_LEVEL