Impostazione dei parametri Device-Specific

Si prevede che la maggior parte dei dispositivi NDIS remoti funzioni bene senza la necessità di configurare i parametri nell'host. Tuttavia, potrebbero verificarsi casi in cui l'operazione di rete appropriata richiede una configurazione nell'host. Se il dispositivo supporta parametri configurabili, deve includere l'OID facoltativo seguente nell'elenco degli OID supportati che segnala in risposta a una query per OID_GEN_SUPPORTED_LIST:

#define OID_GEN_RNDIS_CONFIG_PARAMETER 0x0001021B

Se il dispositivo supporta l'OID OID_GEN_RNDIS_CONFIG_PARAMETER , l'host lo usa per impostare parametri specifici del dispositivo, subito dopo che il dispositivo entra in uno stato inizializzato da Remote NDIS dallo stato non inizializzato. L'host invierà zero o più REMOTE_NDIS_SET_MSGs al dispositivo, con OID_GEN_RNDIS_CONFIG_PARAMETER come valore OID da impostare. Ogni REMOTE_NDIS_SET_MSG corrisponde a un parametro specifico del dispositivo configurato nell'host.

InformationBuffer associato a ogni REMOTE_NDIS_SET_MSG ha il formato seguente. Si noti che i valori Offset sono relativi all'inizio del buffer delle informazioni.

Offset	Dimensione	Campo	Descrizione
0	4	ParameterNameOffset	Specifica l'offset di byte dall'inizio del campo ParameterNameOffset in cui si trova una stringa di caratteri Unicode che rappresenta il nome del parametro. La stringa non include un terminatore NULL.
4	4	ParameterNameLength	Specifica la lunghezza di byte della stringa del nome del parametro.
8	4	ParameterType	Specifica il tipo di dati del valore del parametro. Questo è uno dei seguenti: 0 - valore numerico; 2 - Valore stringa.
12	4	ParameterValueOffset	Specifica l'offset di byte dall'inizio del campo ParameterNameOffset in cui si trova il valore del parametro.
16	4	ParameterValueLength	Specifica la lunghezza di byte del valore del parametro.

Il dispositivo invia un REMOTE_NDIS_SET_CMPLT in risposta a ogni REMOTE_NDIS_SET_MSG, dopo aver applicato il valore del parametro. Se l'impostazione del parametro è accettabile, restituisce uno stato di RNDIS_STATUS_SUCCESS nella risposta. Se l'impostazione del parametro non è accettabile e il dispositivo non può applicare un valore predefinito utile per questo parametro, il dispositivo restituisce un valore di stato di errore appropriato (vedere la sezione sui valori di stato). Se viene restituito uno stato di errore, l'host avvierà un processo di arresto per il dispositivo.

I parametri specifici del dispositivo devono essere configurati nel Registro di sistema di Windows. Le chiavi che definiscono i valori dei parametri vengono in genere create nel Registro di sistema durante il processo di installazione del dispositivo. L'elenco di chiavi, informazioni di tipo, valori predefiniti e intervallo facoltativo di valori validi vengono specificati nel file INF per il dispositivo. Per altre informazioni sull'uso di un INF per configurare i parametri di configurazione nel Registro di sistema per i dispositivi di rete, consultare Windows 2000 Driver Development Kit (DDK).