OID_RECEIVE_FILTER_GLOBAL_PARAMETERS
上部のドライバーは、OID_RECEIVE_FILTER_GLOBAL_PARAMETERS の OID クエリ要求を発行して、ネットワーク アダプターのグローバル受信フィルター パラメーターを取得します。
OID クエリ要求から正常に返されると、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS 構造体へのポインターが含まれます。
解説
NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます。
NDIS Packet Coalescing。 このインターフェイスで受信フィルターを使用する方法の詳細については、「パケット結合受信フィルターの管理」を参照してください。
シングル ルート I/O 仮想化 (SR-IOV)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「仮想ポートでの受信フィルターの設定」を参照してください。
仮想マシン キュー (VMQ)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「VMQ フィルターの設定とクリア」を参照してください。
NDIS 6.20 以降では、プロトコル ドライバーは、OID_RECEIVE_FILTER_GLOBAL_PARAMETERS を使用して、ネットワーク アダプターでフィルター処理を受信するための現在のグローバル構成パラメーターを照会します。 たとえば、プロトコル ドライバーは、この OID を使用して、受信フィルターまたは受信キューの種類が有効か、無効かを判断できます。
状態コードを返す
NDIS は、ミニポート ドライバーに対する OID_RECEIVE_FILTER_GLOBAL_PARAMETERS の OID クエリ要求を処理し、次のいずれかの状態コードを返します。
NDIS_STATUS_SUCCESS
要求は正常に完了しました。
NDIS_STATUS_PENDING
要求の完了が保留中です。 NDIS は、要求が完了した後、呼び出し元の OID 要求完了ハンドラーに最終的な状態コードと結果を渡します。
NDIS_STATUS_INVALID_LENGTH
情報バッファーが短すぎました。 NDIS は、NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファー サイズを設定します。
NDIS_STATUS_INVALID_PARAMETER
この要求は、下位ネットワークアダプターがサポートしていない機能を有効にしようとしたため、失敗しました。
NDIS_STATUS_FAILURE
その他の理由で要求に失敗しました。
要件
バージョン |
NDIS 6.20 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |