NdisIMCancelInitializeDeviceInstance, fonction (ndis.h)
La fonction NdisIMCancelInitializeDeviceInstance annule un appel précédent à la fonction fonction NdisIMInitializeDeviceInstanceEx.
Syntaxe
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
Paramètres
[in] DriverHandle
Le pilote miniport que le fonction NdisMRegisterMiniportDriver retournée au paramètre NdisMiniportDriverHand le.
[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 en tant que type UNICODE_STRING.
Valeur de retour
NdisIMCancelInitializeDeviceInstance retourne NDIS_STATUS_SUCCESS si elle 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 d’un miniport virtuel. Avant d’appeler la fonction MiniportInitializeEx du pilote, le pilote peut appeler NdisIMCancelInitializeDeviceInstance pour annuler l’opération d’initialisation. Par exemple, si un pilote sous-jacent requis par le pilote intermédiaire pour une opération normale est supprimé, le pilote intermédiaire peut annuler l’initialisation pour les miniports virtuels associés au pilote supprimé.