NdisFSynchronousOidRequest, fonction (ndis.h)

Les pilotes de filtre appellent la fonction NdisFSynchronousOidRequest pour provenir d’une nouvelle requête OID synchrone et l’émettre aux pilotes sous-jacents.

Cette fonction est prise en charge dans NDIS 6.81 et versions ultérieures.

Syntaxe

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

Paramètres

[in] NdisFilterModuleHandle

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

Cette fonction retourne les mêmes valeurs que NdisDirectOidRequestsauf que NDIS_STATUS_PENDING n’est jamais retourné par cette fonction.

Remarques

La fonction NdisFSynchronousOidRequest 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. NdisFSynchronousOidRequest ne peut être utilisé que pour les OID pris en charge par NDIS pour une utilisation avec l’interface OID synchrone. La plupart des pilotes de filtre n’ont pas besoin d’appeler NdisFSynchronousOidRequest.

Les pilotes de filtre ne doivent pas terminer FilterDetach jusqu’à ce que les requêtes OID synchrones proviennent du pilote de filtre soient terminées.

Les pilotes de filtre ne sont pas nécessaires pour implémenter FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequestou FilterSynchronousOidRequestComplete pour appeler NdisFSynchronousOidRequest. Comme son nom l’indique, une requête OID synchrone se termine toujours de façon synchrone, de sorte qu’il n’existe aucun rappel asynchrone.

Exigences

Voir aussi

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

interface de requête OID synchrone dans NDIS 6.80