Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Sterowniki protokołu NDIS wystawiają żądania metody identyfikatora obiektu (OID) OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE, aby powiadomić sterownik miniportu, że alokacja została ukończona dla bieżącej partii kolejek odbierania.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY, po której następuje struktura NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS dla każdej kolejki. Po pomyślnym powrocie z żądania metody OID element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do tej samej tablicy struktur, a element członkowski CompletionStatus każdej struktury NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS zawiera stan ukończenia dla każdej kolejki.
Uwagi
Żądanie metody OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE jest opcjonalne dla sterowników NDIS 6.20 i nowszych miniportów. W przypadku sterowników miniportów, które obsługują interfejs kolejki maszyn wirtualnych (VMQ).
Po przydzieleniu co najmniej jednej kolejki odbierania i opcjonalnie ustawieniu filtrów początkowych sterownik protokołu musi wydać żądanie metody OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE, aby powiadomić sterownik miniportu, że alokacja została ukończona dla bieżącej partii kolejek odbierania. Dzięki temu sterownik miniportu równoważy zasoby sprzętowe między wieloma kolejkami odbierania; w razie potrzeby może przydzielić zasoby, takie jak pamięć udostępniona dla kolejek odbierania.
Gdy sterownik miniportu otrzyma żądanie OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE i ma filtry ustawione w kolejce, kolejka jest w stanie Uruchomiony. W tym stanie sterownik miniportu może uruchomić wskazania pakietów w kolejce, wywołując NdisMIndicateReceiveNetBufferLists.
Kody stanu powrotu
Sterownik miniportu zwraca jeden z następujących kodów stanu dla żądania metody OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Alokacja kolejki została ukończona. Bufor informacyjny zawiera zaktualizowaną strukturę NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY i struktury parametrów ze stanem ukończenia alokacji kolejki. |
NDIS_STATUS_PENDING |
Żądanie oczekuje na ukończenie. Końcowy kod stanu i wyniki zostaną przekazane do procedury obsługi uzupełniania żądań OID obiektu wywołującego. |
NDIS_STATUS_INVALID_PARAMETER |
Co najmniej jeden z podanych parametrów sterownika nadmiernego jest nieprawidłowy. |
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_NOT_SUPPORTED |
Wersja sterownika miniportu NDIS jest starsza niż wersja 6.20. |
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) |
Zobacz też
NdisMIndicateReceiveNetBufferLists