NdisIMCancelInitializeDeviceInstance-Funktion (ndis.h)

Die NdisIMCancelInitializeDeviceInstance-Funktion bricht einen vorherigen Aufruf von ab. NdisIMInitializeDeviceInstanceEx-Funktion .

Syntax

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  [in] NDIS_HANDLE  DriverHandle,
  [in] PNDIS_STRING DeviceInstance
);

Parameter

[in] DriverHandle

Der Miniporttreiber behandelt die Die NdisMRegisterMiniportDriver-Funktion wird am Parameter NdisMiniportDriverHandle zurückgegeben.

[in] DeviceInstance

Ein Zeiger auf einen NDIS_STRING Typ, der eine vom Aufrufer initialisierte Gezählte Zeichenfolge im Systemstandardzeichensatz beschreibt. Die Zeichenfolge enthält den Namen des Registrierungsschlüssels, in dem der Treiber Informationen zu einem virtuellen Miniport und möglicherweise bindungsspezifische Informationen speichert. Bei Treibern von Microsoft Windows 2000 und höher enthält diese Zeichenfolge Unicode-Zeichen. Das heißt, für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.

Rückgabewert

NdisIMCancelInitializeDeviceInstance gibt NDIS_STATUS_SUCCESS zurück, wenn der vorherige Aufruf von NdisIMInitializeDeviceInstanceEx abgebrochen wurde. Andernfalls wird NDIS_STATUS_FAILURE zurückgegeben, wenn es keine Möglichkeit gibt, den Initialisierungsvorgang für den virtuellen Miniport zu beenden.

Hinweise

Ein zwischengeschalteter Treiber ruft die NdisIMInitializeDeviceInstanceEx-Funktion zum Initiieren des Initialisierungsvorgangs für virtuelle Miniports. Bevor NDIS die MiniportInitializeEx-Funktion des Treibers aufruft, kann der Treiber NdisIMCancelInitializeDeviceInstance aufrufen, um den Initialisierungsvorgang abzubrechen. Wenn beispielsweise ein zugrunde liegender Treiber entfernt wird, den der Zwischentreiber für den normalen Betrieb benötigt, kann der Zwischentreiber die Initialisierung für alle virtuellen Miniports abbrechen, die dem entfernten Treiber zugeordnet sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_IM_Function(ndis)

Weitere Informationen

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING