Partager via


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 provenir d’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 requête de méthode. Pour plus d’informations sur les OID, consultez NDIS OIDs.

Valeur de retour

Consultez la fonction NdisOidRequest.

Remarques

Les pilotes de filtre peuvent provenir des requêtes OID vers des pilotes sous-jacents en appelant NdisFOidRequest.

Les pilotes de filtre peuvent également filtrer les requêtes OID qui proviennent de pilotes surveillants. NDIS appelle la fonction FilterOidRequest pour traiter chaque demande de ce type.

Si NdisFOidRequest retourne NDIS_STATUS_PENDING, NDIS appelle la fonction FilterOidRequestComplete une fois 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 de requête dans la structure NDIS_OID_REQUEST au 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 d’en-tête de la structure NDIS_OID_REQUEST.

Un pilote peut appeler NdisFOidRequest lorsqu’il se trouve dans le redémarrage, en cours d’exécution, de suspension ou 'état de suspendu.

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible Bureau
d’en-tête ndis.h (include 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