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 provenir d’une telle requête.
Syntaxe
NDIS_STATUS NdisFDirectOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
Paramètres
[in] NdisFilterHandle
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 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 OID, un jeu ou une requête de méthode.
Valeur de retour
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 la fonction NdisFOidRequest à la place. NdisFDirectOidRequest ne peut être utilisé que pour les OID pris en charge par NDIS 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 provenir de requêtes OID directes vers des pilotes sous-jacents en appelant NdisFDirectOidRequest.
Les pilotes de filtre peuvent également filtrer les requêtes OID directes qui proviennent de pilotes surveillant. NDIS appelle la fonction FilterDirectOidRequest pour traiter chaque demande 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 le redémarrage, En cours d’exécution, de suspension ou 'état de suspendu.
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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.1 et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |