Funzione NdisIMDeInitializeDeviceInstance (ndis.h)

  • Articolo

La funzione NdisIMDeInitializeDeviceInstance chiama la funzione MiniportHaltEx di un driver intermedio NDIS per abbattere il miniport virtuale del driver.

Sintassi

NDIS_STATUS NdisIMDeInitializeDeviceInstance(
  [in] NDIS_HANDLE NdisMiniportHandle
);

Parametri

[in] NdisMiniportHandle

Handle fornito dall'NDIS all'oggetto Funzione MiniportInitializeEx .

Valore restituito

NdisIMDeInitializeDeviceInstance restituisce NDIS_STATUS_SUCCESS se la scheda di interfaccia di rete è stata rimossa. In caso contrario, può restituire NDIS_STATUS_FAILURE se l'oggetto NdisMiniportHandle specificato non è valido.

Commenti

Per i driver intermedi NDIS, NdisIMDeInitializeDeviceInstance è il reciproco del Funzione NdisIMInitializeDeviceInstanceEx . Tale driver chiama in genere NdisIMDeInitializeDeviceInstance dal relativo Funzione ProtocolUnbindAdapterEx , quando l'adattatore miniport sottostante a cui è stato associato viene rimosso dal sistema, probabilmente perché viene riconfigurato.

La chiamata a NdisIMDeInitializeDeviceInstance causa una chiamata NDIS alla funzione MiniportHaltEx del driver intermedio dopo che NDIS ha detto a tutti i driver di protocollo di livello superiore che si erano associati al miniport virtuale dell'intermedio che devono annullare l'associazione.

Requisiti

Requisito Valore
Client minimo supportato Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisIMDeInitializeDeviceInstance (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisIMDeInitializeDeviceInstance (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione Desktop
Intestazione ndis.h (include Ndis.h)
Libreria Ndis.lib
IRQL PASSIVE_LEVEL
Regole di conformità DDI Irql_IM_Function(ndis)

Vedi anche

MiniportHaltEx

NdisIMInitializeDeviceInstanceEx

ProtocolUnbindAdapterEx