NdisFOidRequest, fonction (ndis.h)

  • Article

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)

Voir aussi

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest