Funzione NdisIMCancelInitializeDeviceInstance (ndis.h)
La funzione NdisIMCancelInitializeDeviceInstance annulla una chiamata precedente a funzione NdisIMInitializeDeviceInstanceEx.
Sintassi
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
Parametri
[in] DriverHandle
Il driver miniport gestisce il funzione NdisMRegisterMiniportDriver restituita nel parametro NdisMiniportDriverHand le.
[in] DeviceInstance
Puntatore a un tipo di NDIS_STRING che descrive una stringa con conteggiata inizializzata dal chiamante nel set di caratteri predefinito del sistema. La stringa contiene il nome della chiave del Registro di sistema in cui il driver archivia informazioni su un miniport virtuale e, possibilmente, informazioni specifiche dell'associazione. Per i driver Microsoft Windows 2000 e versioni successive, questa stringa contiene caratteri Unicode. Ovvero, per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.
Valore restituito
NdisIMCancelInitializeDeviceInstance restituisce NDIS_STATUS_SUCCESS se ha annullato la chiamata precedente a NdisIMInitializeDeviceInstanceEx. In caso contrario, restituisce NDIS_STATUS_FAILURE se non è possibile arrestare l'operazione di inizializzazione per il miniport virtuale.
Osservazioni
Un driver intermedio chiama funzione NdisIMInitializeDeviceInstanceEx per avviare l'operazione di inizializzazione per un miniport virtuale. Prima che NDIS chiami la funzione miniportInitializeEx del driver, il driver può chiamare NdisIMCancelInitializeDeviceInstance per annullare l'operazione di inizializzazione. Ad esempio, se un driver sottostante richiesto dal driver intermedio per il normale funzionamento viene rimosso, il driver intermedio può annullare l'inizializzazione per qualsiasi miniport virtuale associato al driver rimosso.