NdisFOidRequest, fonction (ndis.h)
Les pilotes de filtre appellent la fonction NdisFOidRequest pour transférer une requête OID aux pilotes sous-jacents ou pour créer une telle requête.
Syntaxe
NDIS_STATUS NdisFOidRequest(
[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, un jeu ou une demande de méthode. Pour plus d’informations sur les OID, consultez NDIS OID.
Valeur retournée
Consultez la fonction NdisOidRequest .
Remarques
Les pilotes de filtre peuvent envoyer des requêtes OID aux pilotes sous-jacents en appelant NdisFOidRequest.
Les pilotes de filtre peuvent également filtrer les requêtes OID qui proviennent de pilotes trop. NDIS appelle la fonction FilterOidRequest pour traiter chacune de ces demandes.
Si NdisFOidRequest retourne NDIS_STATUS_PENDING, NDIS appelle la fonction FilterOidRequestComplete après que les pilotes sous-jacents ont terminé la requête OID.
Si NdisFOidRequest retourne NDIS_STATUS_SUCCESS, il retourne les résultats d’une requête dans la structure NDIS_OID_REQUEST au niveau du paramètre OidRequest .
NdisFOidRequest peut retourner NDIS_STATUS_INVALID_PARAMETER si le pilote de filtre transmet des valeurs non valides pour les champs Type et Taille dans le champ En-tête de la structure NDIS_OID_REQUEST .
Un pilote peut appeler NdisFOidRequest lorsqu’il se trouve dans l’état Redémarrage, Exécution, Suspension ou Pause.
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_OID_Function(ndis) |