OID_RECEIVE_FILTER_ENUM_QUEUES
過度處理驅動程式和使用者模式應用程式會發出物件識別碼, (OID) 查詢要求OID_RECEIVE_FILTER_ENUM_QUEUES,以取得網路介面卡上配置的所有接收佇列清單。
從 OID 查詢要求成功傳回之後,NDIS_OID_REQUEST結構的InformationBuffer成員會包含NDIS_RECEIVE_QUEUE_INFO_ARRAY結構的指標,後面接著每個篩選準則的NDIS_RECEIVE_QUEUE_INFO結構。
備註
NDIS 從從 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 和 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 要求收到的資料內部快取取得資訊。
過度處理驅動程式和使用者模式應用程式會發出 OID 查詢要求,OID_RECEIVE_FILTER_ENUM_QUEUES來列舉網路介面卡上的接收佇列。
如果通訊協定驅動程式發出要求, NDIS_OID_REQUEST 結構內的要求類型會設定為 NdisRequestQueryInformation ,而這個 OID 會傳回網路介面卡上配置之通訊協定驅動程式的所有接收佇列陣列。 如果使用者模式應用程式發出要求, NDIS_OID_REQUEST 結構內的要求類型會設定為 NdisRequestQueryStatistics,而此 OID 會傳回網路介面卡上所有接收佇列的資訊陣列。
傳回狀態碼
NDIS 會處理迷你埠驅動程式OID_RECEIVE_FILTER_ENUM_QUEUES的 OID 查詢要求,並傳回下列其中一個狀態碼。
狀態碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
要求已順利完成。 InformationBuffer指向NDIS_RECEIVE_QUEUE_INFO_ARRAY結構。 |
NDIS_STATUS_PENDING |
要求正在擱置完成。 NDIS 會在要求完成之後,將最終狀態代碼和結果傳遞至呼叫端的 OID 要求完成處理常式。 |
NDIS_STATUS_INVALID_LENGTH |
資訊緩衝區太短。 NDIS 會設定DATA。METHOD_INFORMATION。NDIS_OID_REQUEST結構中的BytesNeeded成員,以達到所需的最小緩衝區大小。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
規格需求
版本 |
NDIS 6.20 和更新版本支援。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |