Funzione NdisOpenProtocolConfiguration (ndis.h)

  • Articolo

Nota NDIS 5. x è stato deprecato ed è sostituito da NDIS 6. x. Per il nuovo sviluppo di driver NDIS, vedere Driver di rete a partire da Windows Vista. Per informazioni sulla conversione di NDIS 5. driver x a NDIS 6. x, vedere Conversione di driver NDIS 5.x in NDIS 6.0.

NdisOpenProtocolConfiguration restituisce un handle per la chiave del Registro di sistema in cui vengono archiviate le informazioni sul driver di protocollo per scheda.

Sintassi

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

Parametri

[out] Status

Puntatore a una variabile fornita dal chiamante impostata su NDIS_STATUS_SUCCESS o su uno stato di errore restituito da questa funzione.

[out] ConfigurationHandle

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce l'handle alla chiave del Registro di sistema per il driver miniport denominato a cui il chiamante si associa in un secondo momento. Le voci di valore in questa chiave contengono informazioni specifiche del protocollo installate dal protocollo.

[in] ProtocolSection

Puntatore a un chiamante fornito NDIS_STRING tipo contenente una stringa conteggiata, specificata nel set di caratteri predefinito del sistema. Questa stringa conteggiata chiama il driver della scheda di interfaccia di rete NDIS, in modo efficace, per cui è necessario aprire la chiave dei parametri per adattatore nella sezione protocollo del Registro di sistema. Per i protocolli Windows 2000 e versioni successive, questa stringa conteggiata contiene caratteri Unicode. Vale a dire, per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo di UNICODE_STRING .

Questo puntatore è il parametro di input SystemSpecific1 alla funzione ProtocolBindAdapter del chiamante.

Valore restituito

nessuno

Osservazioni

NdisOpenProtocolConfiguration restituisce un handle che il chiamante può passare successivamente a Ndis.. Funzioni di configurazione per recuperare o archiviare informazioni nel Registro di sistema.

Un driver di protocollo chiama NdisOpenProtocolConfiguration per ottenere un handle di chiave del Registro di sistema da passare successivamente ad altri Ndis.. Funzioni di configurazione, ad esempio NdisRead/WriteConfiguration o NdisOpenConfigurationKeyByName/Index, se il file di installazione archivia informazioni di configurazione specifiche dell'adattatore nella sezione protocollo del Registro di sistema da cui il protocollo configura le relative associazioni.

Un protocollo può chiamare NdisOpenConfigurationKeyByName o NdisOpenConfigurationKeyByIndex per aprire qualsiasi sottochiave della chiave del Registro di sistema per cui NdisOpenProtocolConfiguration restituisce l'handle.

Windows 2000 e protocolli successivi chiamano routine di supporto in modalità kernel per aprire le proprie chiavi del Registro di sistema specifiche del protocollo. Per altre informazioni su queste routine di supporto, vedere riepilogo delle routine di supporto di Kernel-Mode e routine di supporto di Power Management.

  • Piattaforma di destinazione: universale
  • Versione: non supportata per i driver NDIS 6.0 in Windows Vista. Usare invece NdisOpenConfigurationEx. Supportato per i driver NDIS 5.1 in Windows Vista e Windows XP.

Requisiti

Requisito Valore
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL PASSIVE_LEVEL

Vedi anche