NdisOpenProtocolConfiguration-Funktion (ndis.h)

  • Artikel

Hinweis NDIS 5. x wurde veraltet und wird von NDIS 6 abgelöst. x. Informationen zur Entwicklung neuer NDIS-Treiber finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x-Treiber auf NDIS 6. x, siehe Portieren von NDIS 5.x-Treibern zu NDIS 6.0.

NdisOpenProtocolConfiguration gibt ein Handle für den Registrierungsschlüssel zurück, in dem die Informationen eines Protokolltreibers pro Adapter gespeichert sind.

Syntax

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

Parameter

[out] Status

Zeiger auf eine vom Aufrufer bereitgestellte Variable, die auf NDIS_STATUS_SUCCESS festgelegt ist, oder ein Fehler status bei der Rückgabe von dieser Funktion.

[out] ConfigurationHandle

Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion das Handle an den Registrierungsschlüssel für den benannten Miniporttreiber zurückgibt, an den sich der Aufrufer später binden wird. Werteinträge unter diesem Schlüssel enthalten über das Protokoll installierte, adapterspezifische Informationen.

[in] ProtocolSection

Zeiger auf einen vom Aufrufer bereitgestellten NDIS_STRING Typ mit einer gezählten Zeichenfolge, die im Systemstandardzeichensatz angegeben ist. Diese zählerische Zeichenfolge benennt den NDIS-NIC-Treiber, also den Adapter, für den der Parameterschlüssel pro Adapter im Registrierungsprotokollabschnitt geöffnet werden soll. Bei Protokollen unter Windows 2000 und höher enthält diese gezählte Zeichenfolge Unicode-Zeichen. Das heißt, für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.

Dieser Zeiger ist der SystemSpecific1-Eingabeparameter für die ProtocolBindAdapter-Funktion des Aufrufers.

Rückgabewert

Keine

Bemerkungen

NdisOpenProtocolConfiguration gibt ein Handle zurück, das der Aufrufer anschließend an die Ndis. übergeben kann. Konfigurationsfunktionen zum Abrufen oder Speichern von Informationen in der Registrierung.

Ein Protokolltreiber ruft NdisOpenProtocolConfiguration auf, um ein Registrierungsschlüsselhandle abzurufen, das anschließend an andere Ndis. übergeben werden soll. Konfigurationsfunktionen wie NdisRead/WriteConfiguration oder NdisOpenConfigurationKeyByName/Index, wenn die Installationsdatei adapterspezifische Konfigurationsinformationen im Protokollabschnitt der Registrierung gespeichert hat, aus der das Protokoll seine Bindungen einrichtet.

Ein Protokoll kann NdisOpenConfigurationKeyByName oder NdisOpenConfigurationKeyByIndex aufrufen, um einen beliebigen Unterschlüssel des Registrierungsschlüssels zu öffnen, für den NdisOpenProtocolConfiguration das Handle zurückgibt.

Protokolle unter Windows 2000 und höher rufen Kernelmodus-Supportroutinen auf, um ihre eigenen protokollspezifischen Registrierungsschlüssel zu öffnen. Weitere Informationen zu diesen Supportroutinen finden Sie in der Zusammenfassung der Kernel-Mode Supportroutinen und Power Management-Supportroutinen.

Anforderungen

Anforderung Wert
Header ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL

Weitere Informationen