NdisCmRegisterSapComplete, fonction (ndis.h)
NdisCmRegisterSapComplete retourne la dernière status de la demande d’un client, pour laquelle le cm a précédemment renvoyé NDIS_STATUS_PENDING, pour inscrire un SAP.
Syntaxe
void NdisCmRegisterSapComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisSapHandle,
[in] NDIS_HANDLE CallMgrSapContext
);
Paramètres
[in] Status
Spécifie le status final de la demande d’origine du client pour inscrire le SAP, soit NDIS_STATUS_SUCCESS, soit tout NDIS_STATUS_XXX déterminé par cm, à l’exception de NDIS_STATUS_PENDING.
[in] NdisSapHandle
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 son Fonction ProtocolCmRegisterSap .
[in] CallMgrSapContext
Spécifie le handle d’une zone de contexte résident fournie par l’appelant dans laquelle le cm conserve l’état pour ce SAP si l’inscription réussit. Si c’est le cas, NDIS transmet ce handle au cm lors de 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 gestionnaire d’appels autonome doit appeler NdisCmRegisterSapComplete si sa fonction ProtocolCmRegisterSap a retourné NDIS_STATUS_PENDING lorsqu’elle a été appelée avec le NdisSapHandle donné . L’appel à NdisCmRegisterSapComplete amène NDIS à appeler le client Fonction ProtocolClRegisterSapComplete .
Si le gestionnaire d’appels définit Status sur autre chose que NDIS_STATUS_SUCCESS, il doit considérer le NdisSapHandle non valide dès qu’il appelle NdisCmRegisterSapComplete. Après l’échec d’une inscription SAP, le cm peut libérer ou réutiliser la zone de contexte par SAP qu’il a allouée lorsque NdisCmRegisterSapComplete retourne le contrôle. NDIS publie également son contexte pour SAP si le gestionnaire d’appels échoue à l’inscription.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmRegisterSapComplete. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent NdisMCmRegisterSapComplete.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisCmRegisterSapComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisCmRegisterSapComplete (NDIS 5.1)) dans Windows XP. |
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_CallManager_Function(ndis) |