NdisMCoIndicateStatusEx, fonction (ndis.h)
La fonction NdisMCoIndicateStatusEx signale une modification de l’état d’un adaptateur miniport CoNDIS.
Syntaxe
void NdisMCoIndicateStatusEx(
[in] NDIS_HANDLE MiniportAdapterHandle,
[in, optional] NDIS_HANDLE NdisVcHandle,
[in] PNDIS_STATUS_INDICATION StatusIndication
);
Paramètres
[in] MiniportAdapterHandle
Handle de l’adaptateur miniport que NDIS a passé au paramètre MiniportAdapterHandle du fonction MiniportInitializeEx.
[in, optional] NdisVcHandle
Handle qui identifie la connexion virtuelle (VC). Le pilote miniport a obtenu ce handle en tant que paramètre d’entrée à sa fonction MiniportCoCreateVc, soit lorsqu’un client a configuré un appel sortant, soit lorsque le gestionnaire d’appels a créé un VC pour un point d’accès de service inscrit au client (SAP). Le gestionnaire d’appels a créé le vc pour indiquer une notification d’appel entrant. Pour envoyer l’indication d’état à toutes les liaisons de protocole, définissez ce paramètre sur NULL.
[in] StatusIndication
Pointeur vers une structure NDIS_STATUS_INDICATION qui contient les informations d’état.
Valeur de retour
Aucun
Remarques
Lorsqu’un pilote miniport appelle NdisMCoIndicateStatusEx avec un handle VC NULL pour le paramètre NdisVcHandle, NDIS transfère la notification de modification d’état à tous les pilotes de protocole lié en appelant la fonction ProtocolCoStatusEx de chaque pilote de protocole lié. Un appel à NdisMCoIndicateStatusEx avec un handle NULLNULL VC limite la notification d’état aux clients ou aux gestionnaires d’appels avec utilisant ce handle VC.
Un pilote miniport peut appeler NdisMCoIndicateStatusEx après avoir défini ses attributs d’inscription en appelant le fonction NdisMSetMiniportAttributes de sa fonction MiniportInitializeEx, même si le pilote est toujours dans le contexte de la fonction MiniportInitializeEx. Le pilote ne doit pas appeler NdisMCoIndicateStatusEx après son retour à partir de la fonction MiniportHaltEx.