OID_RECEIVE_FILTER_QUEUE_PARAMETERS
Le surlysage des pilotes émet des demandes de méthode d’identificateur d’objet (OID) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS pour obtenir les paramètres de configuration actuels d’une file d’attente de réception. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_QUEUE_PARAMETERS avec un identificateur de file d’attente de type NDIS_RECEIVE_QUEUE_ID. Après un retour réussi de la requête de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_QUEUE_PARAMETERS.
Le surlysage des pilotes émet des demandes de jeu OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS pour modifier les paramètres de configuration actuels d’une file d’attente. Le pilote overlying fournit un pointeur vers une structure de NDIS_RECEIVE_QUEUE_PARAMETERS dans le Membre InformationBuffer de la structure NDIS_OID_REQUEST.
Remarques
Le surlysement des pilotes émet des demandes de jeu d’OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS pour modifier les paramètres d’une ou plusieurs files d’attente de réception. La requête de jeu OID est facultative pour les pilotes miniport NDIS 6.20 et ultérieurs. Toutefois, la demande OID est obligatoire pour les pilotes miniport qui prennent en charge l’interface de file d’attente de machines virtuelles (VMQ).
Remarque seul le pilote surlysant qui a alloué la file d’attente peut modifier les paramètres de configuration en émettant des requêtes de jeu d’OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS.
Le pilote overlying a obtenu la valeur d’entrée de l’identificateur de file d’attente à partir d’une requête OID de méthode OID_RECEIVE_FILTER_ALLOCATE_QUEUE antérieure.
Une fois que le pilote surlysé alloue une file d’attente, il peut modifier les paramètres de configuration qui ont un indicateur de modification correspondant (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) dans les indicateurs de membre de la structure NDIS_RECEIVE_QUEUE_PARAMETERS. Toutefois, une fois la file d’attente allouée, le pilote surlysant ne peut pas modifier les paramètres de configuration qui n’ont pas d’indicateur de modification correspondant.
Codes d’état de retour
NDIS gère la demande de méthode OID de OID_RECEIVE_FILTER_QUEUE_PARAMETERS pour les pilotes miniports et retourne l’un des codes d’état suivants.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. |
NDIS_STATUS_PENDING |
La requête est en attente d’achèvement. NDIS transmet le code d’état final et les résultats au gestionnaire d’achèvement de la demande OID de l’appelant une fois la demande terminée. |
NDIS_STATUS_INVALID_LENGTH |
La mémoire tampon d’informations était trop courte. NDIS définit le DATA.METHOD_INFORMATION.membre BytesNeededed dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_INVALID_PARAMETER |
La requête a échoué, car elle a essayé d’activer une fonctionnalité que la carte réseau sous-jacente ne prend pas en charge. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Exigences
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |