Abrufen und Aktualisieren von VM-Warteschlangenparametern
Ein überlastender Treiber kann die Konfigurationsparameter einer VM-Warteschlange festlegen, nachdem sie zugewiesen wurde. Außerdem kann ein überlastende Treiber oder eine überlastende Anwendung die aktuellen Parameter für eine Warteschlange und Parameter für die Filter abrufen, die für eine Warteschlange festgelegt sind.
Um die aktuellen Konfigurationsparameter einer Warteschlange zu ändern, können überlastende Treiber die OID_RECEIVE_FILTER_QUEUE_PARAMETERS festlegen der OID-Anforderung verwenden. Der überlastende Treiber stellt einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur im InformationBuffer-Member der NDIS_OID_REQUEST-Struktur bereit.
Die NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur wird in der OID_RECEIVE_FILTER_ALLOCATE_QUEUE OID und der OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID verwendet. Weitere Informationen zum Zuweisen von Warteschlangen finden Sie unter Zuweisen einer VM-Warteschlange.
Um die aktuellen Konfigurationsparameter einer Warteschlange abzurufen, können überlastende Treiber die OID-Anforderung der OID_RECEIVE_FILTER_QUEUE_PARAMETERS-Methode verwenden. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält zunächst einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur mit einem Warteschlangenbezeichner vom Typ NDIS_RECEIVE_QUEUE_ID. Nach erfolgreicher Rückgabe der OID-Methodenanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine NDIS_RECEIVE_QUEUE_PARAMETERS-Struktur .
NDIS verarbeitet die Methodenanforderung für Miniporttreiber. Daher wird die OID-Anforderung der OID_RECEIVE_FILTER_QUEUE_PARAMETERS-Methode für Miniporttreiber nicht angefordert. NDIS hat die Informationen aus einem internen Cache der Daten abgerufen, die es von den OID_RECEIVE_FILTER_ALLOCATE_QUEUE- und OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID-Anforderungen erhalten hat.
Um die aktuellen Konfigurationsparameter eines Filters in einer Empfangswarteschlange abzurufen, können überlastende Treiber die OID-Anforderung der OID_RECEIVE_FILTER_PARAMETERS-Methode verwenden. Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält zunächst einen Zeiger auf eine NDIS_RECEIVE_FILTER_PARAMETERS-Struktur . NDIS verwendet das FilterId-Element in der Eingabestruktur, um den Filter zu identifizieren. Nach erfolgreicher Rückgabe der Methodenanforderung enthält das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur einen Zeiger auf eine aktualisierte NDIS_RECEIVE_FILTER_PARAMETERS-Struktur.
NDIS verarbeitet die OID-Anforderung der OID_RECEIVE_FILTER_PARAMETERS-Methode für Miniporttreiber. NDIS hat die Informationen aus einem internen Cache der Daten abgerufen, die es von der OID_RECEIVE_FILTER_SET_FILTER OID-Anforderung empfangen hat.
Überlastende Treiber können die OID-Anforderung der OID_RECEIVE_FILTER_PARAMETERS-Methode verwenden, um die Konfigurationsparameter für einen Filter in einer Empfangswarteschlange abzurufen.
Der überlastende Treiber hat den Filterbezeichner aus einer früheren OID_RECEIVE_FILTER_SET_FILTER Methoden-OID-Anforderung oder aus der OID_RECEIVE_FILTER_ENUM_FILTERS OID-Anforderung abgerufen. Nur Treiber können die OID_RECEIVE_FILTER_SET_FILTER-Anforderung verwenden.
Eine Anwendung hat den Filterbezeichner aus der OID_RECEIVE_FILTER_ENUM_FILTERS OID-Anforderung abgerufen.