Fonction NdisMCoOidRequestComplete (ndis.h)

Article
03/01/2024

La fonction NdisMCoOidRequestComplete retourne le status final d’une requête OID à un pilote miniport

La fonction MiniportCoOidRequest a retourné NDIS_STATUS_PENDING pour.

Syntaxe

void NdisMCoOidRequestComplete(
  [in] NDIS_HANDLE       MiniportAdapterHandle,
       NDIS_HANDLE       NdisMiniportVcHandle,
       PNDIS_OID_REQUEST Request,
  [in] NDIS_STATUS       Status
);

Paramètres

[in] MiniportAdapterHandle

Poignée d’adaptateur miniport que NDIS a passée au paramètre MiniportAdapterHandle du Fonction MiniportInitializeEx .

NdisMiniportVcHandle

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. Si la requête n’est pas propre à VC, ce paramètre a la valeur NULL.

Request

Pointeur vers une mémoire tampon mise en forme en tant que structure NDIS_OID_REQUEST . Le pilote miniport a obtenu ce pointeur comme paramètre d’entrée vers son Fonction MiniportCoOidRequest .

[in] Status

Le status final de l’opération de requête, soit NDIS_STATUS_SUCCESS, NDIS_STATUS_REQUEST_ABORTED, soit toute valeur NDIS_STATUS_XXX déterminée par le pilote, à l’exception de NDIS_STATUS_PENDING.

Valeur de retour

None

Remarques

Un pilote miniport CoNDIS qui retourne NDIS_STATUS_PENDING à partir de sa fonction MiniportCoOidRequest doit appeler NdisMCoOidRequestComplete une fois que le pilote miniport a terminé l’opération de requête.

Un appel à NdisMCoOidRequestComplete provoque un appel à Fonction ProtocolCoOidRequestComplete du pilote qui a appelé la fonction NdisCoOidRequest .

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)