NdisIMCancelInitializeDeviceInstance, fonction (ndis.h)

  • Article

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

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) dans Windows XP.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL PASSIVE_LEVEL
Règles de conformité DDI Irql_IM_Function(ndis)

Voir aussi

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING