Partager via


Obtention et mise à jour des paramètres de file d’attente de machines virtuelles

Un pilote overlying peut définir les paramètres de configuration d’une file d’attente de machine virtuelle après son allocation. En outre, un pilote ou une application qui se superpose peut obtenir les paramètres actuels d’une file d’attente et les paramètres des filtres définis sur une file d’attente.

Pour modifier les paramètres de configuration actuels d’une file d’attente, les pilotes sur-ment peuvent utiliser la OID_RECEIVE_FILTER_QUEUE_PARAMETERS définir la requête OID. Le pilote overlying fournit un pointeur vers une structure NDIS_RECEIVE_QUEUE_PARAMETERS dans le membre InformationBuffer de la structure NDIS_OID_REQUEST .

La structure NDIS_RECEIVE_QUEUE_PARAMETERS est utilisée dans l’OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE et l’OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS . Pour plus d’informations sur l’allocation de files d’attente, consultez Allocation d’une file d’attente de machine virtuelle.

Pour obtenir les paramètres de configuration actuels d’une file d’attente, les pilotes sur-ment peuvent utiliser la requête OID de la méthode OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient initialement 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 .

NDIS gère la demande de méthode pour les pilotes miniport. Par conséquent, la requête OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS méthode n’est pas demandée pour les pilotes miniport. NDIS a obtenu les informations 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.

Pour obtenir les paramètres de configuration actuels d’un filtre dans une file d’attente de réception, les pilotes sur-ment peuvent utiliser la requête OID de la méthode OID_RECEIVE_FILTER_PARAMETERS . Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient initialement un pointeur vers une structure NDIS_RECEIVE_FILTER_PARAMETERS . NDIS utilise le membre FilterId dans la structure d’entrée pour identifier le filtre. Après un retour réussi de la demande de méthode, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure de NDIS_RECEIVE_FILTER_PARAMETERS mise à jour.

NDIS gère la requête OID OID_RECEIVE_FILTER_PARAMETERS méthode pour les pilotes miniport. NDIS a obtenu les informations d’un cache interne des données qu’il a reçues de la requête OID OID_RECEIVE_FILTER_SET_FILTER .

Les pilotes sur-ment peuvent utiliser la requête OID OID_RECEIVE_FILTER_PARAMETERS méthode pour obtenir les paramètres de configuration d’un filtre dans une file d’attente de réception.

Le pilote overlying a obtenu l’identificateur de filtre à partir d’une requête OID de méthode OID_RECEIVE_FILTER_SET_FILTER antérieure ou de la requête OID OID_RECEIVE_FILTER_ENUM_FILTERS . Seuls les pilotes peuvent utiliser la demande OID_RECEIVE_FILTER_SET_FILTER.

Une application a obtenu l’identificateur de filtre à partir de la requête OID OID_RECEIVE_FILTER_ENUM_FILTERS .