Funzione NdisOpenProtocolConfiguration (ndis.h)
Nota NDIS 5. x è stato deprecato e sostituito da NDIS 6. x. Per i nuovi 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 Porting NDIS 5.x Drivers to NDIS 6.0.
NdisOpenProtocolConfiguration restituisce un handle per la chiave del Registro di sistema in cui vengono archiviate le informazioni per adattatore di un driver di protocollo.
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 uno stato di errore in caso di restituzione 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 verrà associato in un secondo momento. Le voci di valore in questa chiave contengono informazioni specifiche dell'adapter installate dal protocollo.
[in] ProtocolSection
Puntatore a un tipo di NDIS_STRING fornito dal chiamante contenente una stringa con conteggiata, specificata nel set di caratteri predefinito del sistema. Questa stringa conteggiata denomina il driver NDIS NIC, in modo efficace l'adattatore, per cui deve essere aperta la chiave dei parametri per adapter nella sezione del protocollo del Registro di sistema. Per i protocolli Windows 2000 e versioni successive, questa stringa con conteggiata contiene caratteri Unicode. Ovvero, per Windows 2000 e versioni successive, NDIS definisce il tipo di 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 al Ndis.. Configurazione funzioni 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 relativo file di installazione archivia informazioni di configurazione specifiche dell'adapter nella sezione del protocollo del Registro di sistema da cui il protocollo configura le associazioni.
Un protocollo può chiamare NdisOpenConfigurationKeyByName o NdisOpenConfigurationKeyByIndex per aprire qualsiasi sottochiave della chiave del Registro di sistema per cui NdisOpenProtocolConfiguration restituisce l'handle.
I protocolli di Windows 2000 e versioni successive 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 risparmio energia.
- Piattaforma di destinazione: universal
- Versione: non supportata per i driver NDIS 6.0 in Windows Vista. Usare NdisOpenConfigurationEx. Supportato per i driver NDIS 5.1 in Windows Vista e Windows XP.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ndis.h (include Ndis.h) |
| libreria | Ndis.lib |
| IRQL | PASSIVE_LEVEL |