Macro NdisMCmRegisterSapComplete (ndis.h)

Article
02/26/2024

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)