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) |