NdisFDirectOidRequest, fonction (ndis.h)
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_SALes 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 |