OID_RECEIVE_FILTER_QUEUE_PARAMETERS
Nadmierne sterowniki wystawiają żądania metody identyfikatora obiektu (OID) OID_RECEIVE_FILTER_QUEUE_PARAMETERS w celu uzyskania bieżących parametrów konfiguracji kolejki odbierania. Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_QUEUE_PARAMETERS z identyfikatorem kolejki typu NDIS_RECEIVE_QUEUE_ID. Po pomyślnym powrocie z żądania metody OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_QUEUE_PARAMETERS.
Nadmierne sterowniki wydają żądania zestawów identyfikatorów OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS, aby zmienić bieżące parametry konfiguracji kolejki. Sterownik overlying zapewnia wskaźnik do struktury NDIS_RECEIVE_QUEUE_PARAMETERS w InformationBuffer składowej struktury NDIS_OID_REQUEST.
Uwagi
Nadmierne sterowniki wydają żądania zestawu identyfikatorów OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS, aby zmienić parametry co najmniej jednej kolejki odbierającej. Żądanie zestawu identyfikatorów OID jest opcjonalne dla sterowników NDIS 6.20 i nowszych miniportów. Jednak żądanie OID jest obowiązkowe dla sterowników miniportu, które obsługują interfejs kolejki maszyny wirtualnej (VMQ).
Uwaga Tylko sterownik nadmiernie przydzielony do kolejki może zmienić parametry konfiguracji, wydając żądania zestawów identyfikatorów OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS.
Nadmierny sterownik uzyskał wartość wejściową identyfikatora kolejki z wcześniejszego żądania identyfikatora OID metody OID_RECEIVE_FILTER_ALLOCATE_QUEUE.
Po przydzieleniu kolejki przez nadmierny sterownik może zmienić parametry konfiguracji, które mają odpowiednią flagę zmiany (NDIS_RECEIVE_QUEUE_PARAMETER_xxx_CHANGED) w flagi składowej struktury NDIS_RECEIVE_QUEUE_PARAMETERS. Jednak po przydzieleniu kolejki sterownik nadmiernie nie może zmienić parametrów konfiguracji, które nie mają odpowiedniej flagi zmiany.
Kody stanu powrotu
Usługa NDIS obsługuje żądanie metody OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS dla sterowników miniportu i zwraca jeden z następujących kodów stanu.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie zostało ukończone pomyślnie. |
NDIS_STATUS_PENDING |
Żądanie oczekuje na ukończenie. Usługa NDIS przekaże końcowy kod stanu i wyniki do procedury obsługi ukończenia żądania OID obiektu wywołującego po zakończeniu żądania. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny był zbyt krótki. NDIS ustaw DATA.METHOD_INFORMATION.składowej bytesNeeded w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_INVALID_PARAMETER |
Żądanie nie powiodło się, ponieważ podjęto próbę włączenia możliwości, która nie jest obsługiwana przez podstawową kartę sieciową. |
NDIS_STATUS_FAILURE |
Żądanie nie powiodło się z innych powodów. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.20 lub nowszym. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |