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) |