Macro NdisMCmRegisterSapComplete (ndis.h)
NdisMCmRegisterSapComplete retourne la status finale de la requête d’un client, pour laquelle le pilote MCM
Fonction ProtocolCmRegisterSap précédemment retournée NDIS_STATUS_PENDING pour inscrire un SAP.
Syntaxe
void NdisMCmRegisterSapComplete(
_S_,
_H_,
_C_
);
Paramètres
_S_
Spécifie la status finale pour la demande d’origine du client d’inscrire le SAP, NDIS_STATUS_SUCCESS ou tout NDIS_STATUS_XXX déterminé par l’appelant, sauf NDIS_STATUS_PENDING.
_H_
Spécifie le handle fourni par NDIS au SAP si l’inscription réussit. Le gestionnaire d’appels a obtenu ce handle en tant que paramètre d’entrée pour sa fonction ProtocolCmRegisterSap .
_C_
Spécifie le handle d’une zone de contexte résident fournie par l’appelant dans laquelle le pilote MCM conserve l’état pour ce SAP si l’inscription réussit. Si c’est le cas, NDIS transmet ce handle au pilote MCM dans tous les appels suivants concernant ce SAP. Si Status est défini sur autre chose que NDIS_STATUS_SUCCESS, NDIS ignore ce paramètre.
Valeur de retour
None
Remarques
Un pilote MCM doit appeler NdisMCmRegisterSapComplete si sa fonction ProtocolCmRegisterSap a retourné NDIS_STATUS_PENDING lorsqu’il a été appelé avec le NdisSapHandle donné. L’appel à NdisMCmRegisterSapComplete amène NDIS à appeler le client Fonction ProtocolClRegisterSapComplete .
Si le pilote MCM définit Status sur autre chose que NDIS_STATUS_SUCCESS, il doit considérer le NdisSapHandle non valide lorsque NdisMCmRegisterSapComplete retourne le contrôle. Après l’échec d’une inscription SAP, le cm peut libérer ou réutiliser la zone de contexte par SAP, le cas échéant, qu’elle a déjà allouée. NDIS publie également son contexte pour SAP si le pilote MCM échoue à l’inscription.
Seuls les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels peuvent appeler NdisMCmRegisterSapComplete. Les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, appellent NdisCmRegisterSapComplete à la place.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmRegisterSapComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmRegisterSapComplete (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ndis.h (inclure Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | Irql_MCM_Function(ndis) |