OID_RECEIVE_FILTER_QUEUE_PARAMETERS

Les pilotes qui sur-mentent émettent 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 demande de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_QUEUE_PARAMETERS .

Les pilotes sur-ment émettent des demandes de jeu d’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 NDIS_RECEIVE_QUEUE_PARAMETERS dans le membre InformationBuffer de la structure NDIS_OID_REQUEST .

Notes

Les pilotes sur-ment émettent 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 demande de jeu d’OID est facultative pour les pilotes miniport NDIS 6.20 et ultérieur. Toutefois, la requête OID est obligatoire pour les pilotes miniport qui prennent en charge l’interface de file d’attente de machines virtuelles (VMQ).

Note Seul le pilote qui a alloué la file d’attente peut modifier les paramètres de configuration en émettant des demandes 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 overlying 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 le membre Flags de la structure NDIS_RECEIVE_QUEUE_PARAMETERS . Toutefois, une fois la file d’attente allouée, le pilote overlying 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 miniport et retourne l’un des codes de status suivants.

Code d’état	Description
NDIS_STATUS_SUCCESS	La demande s’est terminée avec succès.
NDIS_STATUS_PENDING	La demande est en attente d’achèvement. NDIS transmet le code status final et les résultats au gestionnaire d’achèvement de la requête 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 les DONNÉES. METHOD_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_INVALID_PARAMETER	La demande a échoué, car elle a tenté 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.

Spécifications

Version	Pris en charge dans NDIS 6.20 et versions ultérieures.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS