OID_RECEIVE_FILTER_ENUM_QUEUES
Les pilotes et les applications en mode utilisateur excessives émettent des requêtes d’identificateur d’objet (OID) de OID_RECEIVE_FILTER_ENUM_QUEUES pour obtenir la liste de toutes les files d’attente de réception allouées sur une carte réseau.
Après un retour réussi à partir de la requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure de NDIS_RECEIVE_QUEUE_INFO_ARRAY qui est suivi d’une structure NDIS_RECEIVE_QUEUE_INFO pour chaque filtre.
Notes
NDIS a obtenu les informations à partir d’un cache interne des données qu’il a reçues du OID_RECEIVE_FILTER_ALLOCATE_QUEUE et OID_RECEIVE_FILTER_QUEUE_PARAMETERS requêtes OID.
Les pilotes et les applications en mode utilisateur excessives émettent des requêtes OID de OID_RECEIVE_FILTER_ENUM_QUEUES pour énumérer les files d’attente de réception sur une carte réseau.
Si un pilote de protocole émet la requête, le type de requête à l’intérieur de la structure NDIS_OID_REQUEST est défini sur NdisRequestQueryInformation et cet OID retourne un tableau de toutes les files d’attente de réception que le pilote de protocole a allouées sur la carte réseau. Si une application en mode utilisateur a émis la demande, le type de requête à l’intérieur de la structure NDIS_OID_REQUEST est défini sur NdisRequestQueryStatistics, et cet OID retourne un tableau d’informations pour toutes les files d’attente de réception sur la carte réseau.
Codes d’état de retour
NDIS gère la requête OID de OID_RECEIVE_FILTER_ENUM_QUEUES pour les pilotes miniport et retourne l’un des codes status suivants.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande s’est terminée avec succès. InformationBuffer pointe vers une structure NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
NDIS_STATUS_PENDING |
La demande est en attente d’achèvement. NDIS transmet le code status final et les résultats au gestionnaire de saisie semi-automatique 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 les DONNÉES. METHOD_INFORMATION. BytesNeeded member dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
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) |