NdisOpenProtocolConfiguration-Funktion (ndis.h)
Hinweis NDIS 5. x ist veraltet und wird von NDIS 6 ersetzt. x. Informationen zur neuen NDIS-Treiberentwicklung finden Sie unter Netzwerktreiber ab Windows Vista. Informationen zum Portieren von NDIS 5. x Treiber auf NDIS 6. xfinden Sie unter 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 werden.
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 oder einen Fehlerstatus festgelegt ist, der von dieser Funktion zurückgegeben wird.
[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 der Aufrufer später gebunden wird. Werteinträge unter diesem Schlüssel enthalten protokoll installierte adapterspezifische Informationen.
[in] ProtocolSection
Zeiger auf einen vom Aufrufer bereitgestellten NDIS_STRING Typ, der eine gezählte Zeichenfolge enthält, die im Systemstandardzeichensatz angegeben ist. Diese Zeichenfolge benennt den NDIS-NIC-Treiber, effektiv den Adapter, für den der Parameterschlüssel pro Adapter im Registrierungsprotokollabschnitt geöffnet werden soll. Für Windows 2000- und höhere Protokolle enthält diese gezählte Zeichenfolge Unicode-Zeichen. 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
Nichts
Bemerkungen
NdisOpenProtocolConfiguration gibt ein Handle zurück, das der Aufrufer anschließend an die Ndis übergeben kann. Konfiguration Funktionen 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. Konfigurations- Funktionen, z. B. NdisRead/WriteConfiguration oder NdisOpenConfigurationKeyByName/Index, wenn ihre Installationsdatei adapterspezifische Konfigurationsinformationen im Protokollabschnitt der Registrierung gespeichert ist, 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.
Windows 2000- und höhere Protokolle rufen Kernelmodusunterstützungsroutinen 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 Support Routines.
- Zielplattform: universelle
- Version: Für NDIS 6.0-Treiber in Windows Vista nicht unterstützt. Verwenden Sie stattdessen NdisOpenConfigurationEx-. Unterstützt für NDIS 5.1-Treiber in Windows Vista und Windows XP.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | PASSIVE_LEVEL |