Partager via


NdisMCoIndicateStatusEx, fonction (ndis.h)

La fonction NdisMCoIndicateStatusEx signale une modification de la status 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 pour 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 (SAP) inscrit au client. Le gestionnaire d’appels a créé le vc pour indiquer une notification d’appel entrant. Pour envoyer l’indication status à toutes les liaisons de protocole, définissez ce paramètre sur NULL.

[in] StatusIndication

Pointeur vers une structure de NDIS_STATUS_INDICATION qui contient les informations status.

Valeur de retour

None

Remarques

Lorsqu’un pilote miniport appelle NdisMCoIndicateStatusEx avec un handle VC NULL pour le paramètre NdisVcHandle, NDIS transfère la notification de modification de status à tous les pilotes de protocole lié en appelant la fonction ProtocolCoStatusEx de chaque pilote de protocole lié. Un appel à NdisMCoIndicateStatusEx avec un handle VC non NULL limite la notification status aux clients ou aux gestionnaires d’appels avec qui le pilote miniport partage ce handle VC.

Un pilote miniport peut appeler NdisMCoIndicateStatusEx après avoir défini ses attributs d’inscription, en appelant le Fonction NdisMSetMiniportAttributes à partir 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 qu’il est retourné à partir de la fonction MiniportHaltEx .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_MCO_Function(ndis)

Voir aussi

MiniportCoCreateVc

MiniportHaltEx

MiniportInitializeEx

NDIS_STATUS_INDICATION

NdisMSetMiniportAttributes

ProtocolCoStatusEx