NdisFDirectOidRequest, fonction (ndis.h)

Article
02/26/2024

Les pilotes de filtre appellent la fonction NdisFDirectOidRequest pour transférer une requête OID directe aux pilotes sous-jacents ou pour créer une telle demande.

Syntaxe

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Paramètres

[in] NdisFilterHandle

Un handle NDIS qui identifie un module de filtre. NDIS a passé le handle au pilote de filtre dans un appel à la fonction FilterAttach .

[in] OidRequest

Pointeur vers une structure de NDIS_OID_REQUEST qui spécifie l’opération demandée avec un code OID_Xxx donné. La structure peut spécifier une requête, un jeu ou une demande de méthode OID.

Valeur retournée

Pour obtenir la liste des valeurs de retour possibles, consultez la fonction NdisDirectOidRequest .

Remarques

La fonction NdisFDirectOidRequest ne peut pas être utilisée pour les requêtes OID générales. Pour les requêtes OID générales, utilisez plutôt la fonction NdisFOidRequest . NdisFDirectOidRequest ne peut être utilisé que pour les OID que NDIS prend en charge pour une utilisation avec l’interface OID directe. Par exemple, les OID suivants peuvent être utilisés :

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

Les pilotes de filtre peuvent créer des requêtes OID directes vers les pilotes sous-jacents en appelant NdisFDirectOidRequest.

Les pilotes de filtre peuvent également filtrer les requêtes OID directes qui sont générées par des pilotes qui se superposent. NDIS appelle la fonction FilterDirectOidRequest pour traiter chaque requête de ce type.

Si NdisFDirectOidRequest retourne NDIS_STATUS_PENDING, NDIS appelle la fonction FilterDirectOidRequestComplete une fois que les pilotes sous-jacents ont terminé la requête OID. Un pilote qui appelle NdisFDirectOidRequest doit inscrire la fonction FilterDirectOidRequestComplete .

Un pilote peut appeler NdisFDirectOidRequest lorsqu’il se trouve dans l’état Redémarrage, Exécution, Suspension ou Pause .

L’interface de requête OID directe est similaire à l’interface de requête OID générale. Pour plus d’informations sur l’émission de demandes générales, consultez NdisFOidRequest.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.1 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