Uzyskiwanie i aktualizowanie parametrów kolejki VM

Nakładający się sterownik może ustawić parametry konfiguracji kolejki maszyny wirtualnej po przydzieleniu. Ponadto nadrzędny sterownik lub aplikacja może uzyskać bieżące parametry kolejki oraz parametry filtrów ustawionych na kolejce.

Aby zmienić bieżące parametry konfiguracji kolejki, nakładające się sterowniki mogą używać żądania ustawienia OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Przylegający sterownik udostępnia wskaźnik do struktury NDIS_RECEIVE_QUEUE_PARAMETERS w składowej InformationBuffer struktury NDIS_OID_REQUEST.

Struktura NDIS_RECEIVE_QUEUE_PARAMETERS jest używana w identyfikatorze OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE i identyfikatorze OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Aby uzyskać więcej informacji na temat przydzielania kolejek, zobacz przydzielanie kolejki VM.

Aby uzyskać bieżące parametry konfiguracji kolejki, nadrzędne sterowniki mogą używać żądania metody OID o nazwie OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Członek struktury InformationBuffer w strukturze NDIS_OID_REQUEST początkowo zawiera wskaźnik na strukturę NDIS_RECEIVE_QUEUE_PARAMETERS z identyfikatorem kolejki typu NDIS_RECEIVE_QUEUE_ID. Po pomyślnym zakończeniu żądania metody OID członek InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_QUEUE_PARAMETERS.

NDIS obsługuje żądanie metod dla sterowników miniportu. W związku z tym żądanie OID dotyczące metody OID_RECEIVE_FILTER_QUEUE_PARAMETERS nie jest wymagane dla sterowników miniportu. NDIS uzyskał informacje z wewnętrznej pamięci podręcznej danych otrzymanych z OID_RECEIVE_FILTER_ALLOCATE_QUEUE i OID_RECEIVE_FILTER_QUEUE_PARAMETERS żądań OID.

Aby uzyskać bieżące parametry konfiguracji filtru w kolejce odbierającej, sterowniki nadrzędne mogą używać żądania OID typu OID_RECEIVE_FILTER_PARAMETERS. Element członkowski InformationBuffer struktury NDIS_OID_REQUEST początkowo zawiera wskaźnik do struktury NDIS_RECEIVE_FILTER_PARAMETERS. Usługa NDIS używa elementu członkowskiego FilterId w strukturze danych wejściowych do zidentyfikowania filtru. Po pomyślnym zakończeniu żądania metody, członek InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do zaktualizowanej struktury NDIS_RECEIVE_FILTER_PARAMETERS.

NDIS przetwarza żądanie metody OID_RECEIVE_FILTER_PARAMETERS OID dla sterowników miniportów. Usługa NDIS uzyskała informacje z wewnętrznej pamięci podręcznej danych, które otrzymała z żądania OID_RECEIVE_FILTER_SET_FILTER OID.

Sterowniki nadrzędne mogą używać żądania OID metody OID_RECEIVE_FILTER_PARAMETERS w celu pobrania parametrów konfiguracji filtru na kolejce odbiorczej.

Nadrzędny sterownik uzyskał identyfikator filtru z wcześniejszego żądania OID metody OID_RECEIVE_FILTER_SET_FILTER lub z żądania OID OID_RECEIVE_FILTER_ENUM_FILTERS. Tylko sterowniki mogą używać żądania OID_RECEIVE_FILTER_SET_FILTER.

Aplikacja uzyskała identyfikator filtru z żądania OID_RECEIVE_FILTER_ENUM_FILTERS OID.