Festlegen Device-Specific Parameter

Es wird erwartet, dass die meisten Remote-NDIS-Geräte gut funktionieren, ohne dass Parameter auf dem Host konfiguriert werden müssen. Es kann jedoch vorkommen, dass für den ordnungsgemäßen Netzwerkbetrieb eine Konfiguration auf dem Host erforderlich ist. Wenn das Gerät konfigurierbare Parameter unterstützt, sollte es die folgende optionale OID in der Liste der unterstützten OIDs enthalten, die es als Antwort auf eine Abfrage für OID_GEN_SUPPORTED_LIST meldet:

#define OID_GEN_RNDIS_CONFIG_PARAMETER 0x0001021B

Wenn das Gerät die OID_GEN_RNDIS_CONFIG_PARAMETER OID unterstützt, verwendet der Host sie, um gerätespezifische Parameter festzulegen, kurz nachdem das Gerät in einen Zustand eintritt, der von Remote-NDIS aus dem nicht initialisierten Zustand initialisiert wurde. Der Host sendet null oder mehr REMOTE_NDIS_SET_MSGs an das Gerät, wobei OID_GEN_RNDIS_CONFIG_PARAMETER als OID-Wert festgelegt werden soll. Jede dieser REMOTE_NDIS_SET_MSG entspricht einem gerätespezifischen Parameter, der auf dem Host konfiguriert ist.

Der InformationBuffer , der jedem dieser REMOTE_NDIS_SET_MSG zugeordnet ist, hat das folgende Format. Beachten Sie, dass die Offset-Werte relativ zum Anfang des Informationspuffers sind.

Offset	Size	Feld	BESCHREIBUNG
0	4	ParameterNameOffset	Gibt den Byteoffset vom Anfang des Felds ParameterNameOffset an, an dem sich eine Unicode-Zeichenfolge befindet, die den Parameternamen darstellt. Die Zeichenfolge enthält keinen NULL-Abschlussator.
4	4	ParameterNameLength	Gibt die Bytelänge der Parameternamenzeichenfolge an.
8	4	ParameterType	Gibt den Datentyp des Parameterwerts an. Dies ist einer der folgenden: 0 - numerischer Wert; 2 : Zeichenfolgenwert.
12	4	ParameterValueOffset	Gibt den Byteoffset vom Anfang des Felds ParameterNameOffset an, an dem sich der Parameterwert befindet.
16	4	ParameterValueLength	Gibt die Bytelänge des Parameterwerts an.

Das Gerät sendet eine REMOTE_NDIS_SET_CMPLT als Antwort auf jeden REMOTE_NDIS_SET_MSG, nachdem der Parameterwert angewendet wurde. Wenn die Parametereinstellung akzeptabel ist, gibt sie eine status von RNDIS_STATUS_SUCCESS in der Antwort zurück. Wenn die Parametereinstellung nicht akzeptabel ist und das Gerät keinen nützlichen Standardwert für diesen Parameter anwenden kann, gibt das Gerät einen entsprechenden Fehler status Wert zurück (siehe Abschnitt zu status-Werten). Wenn ein Fehler status zurückgegeben wird, initiiert der Host einen Angehalten-Prozess für das Gerät.

Es wird erwartet, dass gerätespezifische Parameter in der Windows-Registrierung konfiguriert werden. Die Schlüssel, die Parameterwerte definieren, werden in der Regel während der Geräteinstallation in der Registrierung erstellt. Die Liste der Schlüssel, Typinformationen, Standardwerte und optionaler Gültigkeitsbereich werden in der INF-Datei für das Gerät angegeben. Weitere Informationen zur Verwendung eines INF zum Einrichten von Konfigurationsparametern in der Registrierung für Netzwerkgeräte finden Sie im Windows 2000 Driver Development Kit (DDK).