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) |