OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE
Ovladače protokolu NDIS vydávají požadavky metody identifikátoru objektu (OID) OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE, aby oznámil ovladač miniportu, že přidělení bylo dokončeno pro aktuální dávku příjmových front.
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na strukturu NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY, za kterou následuje struktura NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS pro každou frontu. Po úspěšném návratu z požadavku metody OID obsahuje InformationBuffer člen struktury NDIS_OID_REQUEST ukazatel na stejnou matici struktur a CompletionStatus člen každé struktury NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_PARAMETERS obsahuje stav dokončení pro každou frontu.
Poznámky
Požadavek metody OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE je volitelný pro ovladače miniportu NDIS 6.20 a novější. Pro ovladače miniportu, které podporují rozhraní fronty virtuálních počítačů (VMQ), je povinné.
Po přidělení jedné nebo více front příjmu a volitelném nastavení počátečních filtrů musí ovladač protokolu vydat žádost o metodu OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE, aby oznámil ovladač miniportu, že přidělení bylo dokončeno pro aktuální dávku příjmových front. Díky tomu může ovladač miniportu vyrovnávat hardwarové prostředky mezi několika frontami příjmu; v případě potřeby může přidělit prostředky, jako je sdílená paměť pro fronty příjmu.
Jakmile ovladač miniportu obdrží požadavek OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE a má filtry nastavené ve frontě, fronta je ve stavu Spuštěno. V tomto stavu může ovladač miniportu zahájit označení paketů ve frontě voláním NdisMIndicateReceiveNetBufferLists.
Návratové stavové kódy
Ovladač miniportu vrátí jeden z následujících stavových kódů pro požadavek metody OID OID_RECEIVE_FILTER_QUEUE_ALLOCATION_COMPLETE.
| Stavový kód | Popis |
|---|---|
NDIS_STATUS_SUCCESS |
Přidělení fronty bylo dokončeno. Vyrovnávací paměť informací obsahuje aktualizovanou strukturu NDIS_RECEIVE_QUEUE_ALLOCATION_COMPLETE_ARRAY a struktury parametrů se stavem dokončení přidělení fronty. |
NDIS_STATUS_PENDING |
Požadavek čeká na dokončení. Konečný stavový kód a výsledky se předají obslužné rutině dokončení požadavku OID volajícího. |
NDIS_STATUS_INVALID_PARAMETER |
Jeden nebo více parametrů, které zadanou nadlimitní ovladač nebyl platný. |
NDIS_STATUS_INVALID_LENGTH |
Informační vyrovnávací paměť byla příliš krátká. Rozhraní NDIS nastavil dat.METHOD_INFORMATION.bytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti. |
NDIS_STATUS_NOT_SUPPORTED |
Verze ovladače miniportu NDIS je starší než verze 6.20. |
NDIS_STATUS_FAILURE |
Žádost se nezdařila z jiných důvodů. |
Požadavky
Verze |
Podporováno v NDIS 6.20 a novějších verzích. |
Záhlaví |
Ntddndis.h (včetně Ndis.h) |
Viz také
NdisMIndicateReceiveNetBufferLists