Funzione NdisIMCancelInitializeDeviceInstance (ndis.h)

La funzione NdisIMCancelInitializeDeviceInstance annulla una chiamata precedente all'oggetto Funzione NdisIMInitializeDeviceInstanceEx .

Sintassi

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

Parametri

[in] DriverHandle

Il driver miniport gestisce che Funzione NdisMRegisterMiniportDriver restituita nel parametro NdisMiniportDriverHandle .

[in] DeviceInstance

Puntatore a un tipo di NDIS_STRING che descrive una stringa conteggiata con conteggio 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, eventualmente, informazioni specifiche dell'associazione. Per i driver Microsoft Windows 2000 e versioni successive, questa stringa contiene caratteri Unicode. Vale a dire, per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo di UNICODE_STRING .

Valore restituito

NdisIMCancelInitializeDeviceInstance restituisce NDIS_STATUS_SUCCESS se annulla la chiamata precedente a NdisIMInitializeDeviceInstanceEx. In caso contrario, restituisce NDIS_STATUS_FAILURE se non è possibile arrestare l'operazione di inizializzazione per il miniport virtuale.

Commenti

Un driver intermedio chiama il Funzione NdisIMInitializeDeviceInstanceEx per avviare l'operazione di inizializzazione per un miniport virtuale. Prima di NDIS chiama 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 la normale operazione viene rimosso, il driver intermedio può annullare l'inizializzazione per qualsiasi miniport virtuale associato al driver rimosso.

Requisiti

Vedi anche

MiniportInitializeEx

NdisMRegisterMiniportDriver

UNICODE_STRING