NdisMRegisterWdiMiniportDriver-Funktion (dot11wdi.h)

  • Artikel

Wichtig

Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen.

Ein Miniporttreiber ruft die NdisMRegisterWdiMiniportDriver-Funktion auf, um MiniportWdiXxx-Einstiegspunkte bei NDIS als ersten Schritt der Initialisierung zu registrieren.

Syntax

NDIS_EXPORTED_ROUTINE NDIS_STATUS NdisMRegisterWdiMiniportDriver(
  [in]           DRIVER_OBJECT                            *DriverObject,
  [in]           PCUNICODE_STRING                         RegistryPath,
  [in, optional] NDIS_MINIPORT_DRIVER_CONTEXT             NdisDriverContext,
  [in]           NDIS_MINIPORT_DRIVER_CHARACTERISTICS     *MiniportDriverCharacteristics,
  [in]           NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS *MiniportWdiCharacteristics,
  [out]          NDIS_MINIPORT_DRIVER_HANDLE              *NdisMiniportDriverHandle
);

Parameter

[in] DriverObject

Ein Zeiger auf ein undurchsichtiges Treiberobjekt, das der Miniporttreiber in seiner DriverEntry-Routine am Parameter Argument1 empfangen hat (siehe DriverEntry of NDIS Miniport Drivers).

[in] RegistryPath

Ein Zeiger auf einen undurchsichtigen Registrierungspfad, den der Miniporttreiber in seiner DriverEntry-Routine am Parameter Argument2 empfangen hat.

[in, optional] NdisDriverContext

Ein Handle für einen vom Treiber zugewiesenen Kontextbereich, in dem der Treiber Zustands- und Konfigurationsinformationen verwaltet.

[in] MiniportDriverCharacteristics

Ein Zeiger auf einen NDIS_MINIPORT_DRIVER_CHARACTERISTICS Struktur, die der Aufrufer initialisiert hat.

[in] MiniportWdiCharacteristics

Ein Zeiger auf eine NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS Struktur, die der Aufrufer initialisiert hat.

[out] NdisMiniportDriverHandle

Ein Zeiger auf eine vom Aufrufer bereitgestellte Handle-Variable. NDIS schreibt ein Handle in diese Variable, das diesen Treiber eindeutig identifiziert. Der Treiber muss dieses Handle für die Verwendung in nachfolgenden NdisXxx-Funktionsaufrufen speichern.

Rückgabewert

NdisMRegisterWdiMiniportDriver kann einen der folgenden Rückgabewerte zurückgeben.

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 NdisMRegisterWdiMiniportDriver hat den WDI-Miniporttreiber erfolgreich registriert.
NDIS_STATUS_BAD_CHARACTERISTICS
 Der CharacteristicsLength-Parameter ist für die NDIS-Version falsch, die am MajorNdisVersion-Member in der Struktur unter MiniportDriverCharacteristics angegeben wird.
NDIS_STATUS_BAD_VERSION
 Die in der Merkmalsstruktur angegebene MajorNdisVersion oder MinorNdisVersion ist ungültig.
NDIS_STATUS_RESOURCES
 Ein Mangel an Ressourcen, möglicherweise Arbeitsspeicher, verhinderte, dass NDIS den Aufrufer registriert.
NDIS_STATUS_FAILURE
 Dies ist ein Standardfehler status, der zurückgegeben wird, wenn keiner der vorherigen Fehler dazu geführt hat, dass die Registrierung fehlschlägt.
Andere NDIS_STATUS Codes
 Ein geeigneter NDIS_STATUS Code im Falle eines Fehlers.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile dot11wdi.h
Bibliothek Ndis.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

DRIVER_OBJECT

NDIS_MINIPORT_DRIVER_CHARACTERISTICS

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS