NdisIMCancelInitializeDeviceInstance, fonction (ndis.h)

La fonction NdisIMCancelInitializeDeviceInstance annule un appel précédent à Fonction NdisIMInitializeDeviceInstanceEx .

Syntaxe

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

Paramètres

[in] DriverHandle

Le pilote miniport handle que le Fonction NdisMRegisterMiniportDriver retournée au paramètre NdisMiniportDriverHandle .

[in] DeviceInstance

Pointeur vers un type NDIS_STRING qui décrit une chaîne comptée initialisée par l’appelant dans le jeu de caractères par défaut du système. La chaîne contient le nom de la clé de Registre dans laquelle le pilote stocke des informations sur un miniport virtuel et, éventuellement, des informations spécifiques à la liaison. Pour les pilotes Microsoft Windows 2000 et versions ultérieures, cette chaîne contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

Valeur retournée

NdisIMCancelInitializeDeviceInstance retourne NDIS_STATUS_SUCCESS s’il a annulé l’appel précédent à NdisIMInitializeDeviceInstanceEx. Sinon, elle retourne NDIS_STATUS_FAILURE s’il n’existe aucun moyen d’arrêter l’opération d’initialisation pour le miniport virtuel.

Remarques

Un pilote intermédiaire appelle le Fonction NdisIMInitializeDeviceInstanceEx pour lancer l’opération d’initialisation pour un miniport virtuel. Avant que NDIS appelle la fonction MiniportInitializeEx du pilote, le pilote peut appeler NdisIMCancelInitializeDeviceInstance pour annuler l’opération d’initialisation. Par exemple, si un pilote sous-jacent dont le pilote intermédiaire a besoin pour un fonctionnement normal est supprimé, le pilote intermédiaire peut annuler l’initialisation de tous les miniports virtuels associés au pilote supprimé.

Configuration requise

Voir aussi

MiniportInitializeEx

NdisMRegisterMiniportDriver

UNICODE_STRING