NdisCmRegisterSapComplete, fonction (ndis.h)

  • Article

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)

Voir aussi

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap