NdisCoOidRequestComplete, fonction (ndis.h)

Article
02/29/2024

La fonction NdisCoOidRequestComplete retourne la status finale d’une requête OID pour laquelle la fonction ProtocolCoOidRequest d’un client CoNDIS ou du gestionnaire d’appels autonome a précédemment retournée NDIS_STATUS_PENDING.

Syntaxe

void NdisCoOidRequestComplete(
  [in]           NDIS_HANDLE       NdisAfHandle,
  [in, optional] NDIS_HANDLE       NdisVcHandle,
  [in, optional] NDIS_HANDLE       NdisPartyHandle,
  [in]           PNDIS_OID_REQUEST OidRequest,
  [in]           NDIS_STATUS       Status
);

Paramètres

[in] NdisAfHandle

Un handle de famille d’adresses (AF) que NDIS a transmis au client ou au gestionnaire d’appels autonome Fonction ProtocolCoOidRequest .

[in, optional] NdisVcHandle

Un handle de connexion virtuelle (VC) que NDIS a transmis au client ou à la fonction ProtocolCoOidRequest du gestionnaire d’appels autonome. Une valeur NULL pour ce paramètre indique que la requête n’est pas spécifique à VC. Ce paramètre a la valeur NULL si l’appelant de la fonction NdisCoOidRequest ou NdisMCmOidRequest a spécifié un handle VC NULL .

[in, optional] NdisPartyHandle

Un handle de partie que NDIS a transmis au client ou à la fonction ProtocolCoOidRequest du gestionnaire d’appels autonome. Une valeur NULL pour ce paramètre indique que la demande n’est pas spécifique à une partie. Ce paramètre a la valeur NULL si l’appelant de la fonction NdisCoOidRequest ou NdisMCmOidRequest a spécifié un handle de partie NULL .

[in] OidRequest

Pointeur vers une mémoire tampon mise en forme en tant que structure NDIS_OID_REQUEST . L’appelant de la fonction NdisCoOidRequest ou NdisMCmOidRequest a fourni cette mémoire tampon.

[in] Status

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

Valeur de retour

None

Remarques

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

Après qu’un pilote a appelé NdisCoOidRequestComplete, NDIS appelle le Fonction ProtocolCoOidRequestComplete du pilote qui a appelé à l’origine la fonction NdisCoOidRequest ou NdisMCmOidRequest .

Seuls les clients et les gestionnaires d’appels autonomes, qui s’inscrivent avec NDIS en tant que pilotes de protocole, peuvent appeler NdisCoOidRequestComplete. Les gestionnaires d’appels miniport (MCM) appellent le Fonction NdisMCmOidRequestComplete ou NdisMCoOidRequestComplete à la place, selon que la fonction ProtocolCoOidRequest ou MiniportCoOidRequest du pilote MCM, respectivement, a géré la demande du client.

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_Connection_Function(ndis)