OID_PACKET_COALESCING_FILTER_MATCH_COUNT
NDIS は、OID_PACKET_COALESCING_FILTER_MATCH_COUNT の OID クエリ要求を発行して、ネットワーク アダプターでキャッシュまたは結合されたパケットの数を取得します。 ネットワーク アダプターは、アダプターが NDIS パケットの結合が有効で、パケットが受信フィルターに一致する場合、受信したパケットを結合します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、呼び出し元によって割り当てられた ULONG64 変数へのポインターが含まれています。 ドライバーは、クエリ要求から正常に返される前に、ネットワーク アダプターの受信フィルターに一致したパケットの数で ULONG64 変数を更新します。
解説
NDIS 6.30 以降では、NDIS パケット結合をサポートするドライバーは、OID_PACKET_COALESCING_FILTER_MATCH_COUNT の OID クエリ要求をサポートする必要があります。
注 この OID の OID クエリ要求をサポートするために、シングル ルート I/O 仮想化 (SR-IOV) または 仮想マシン キュー (VMQ) インターフェイスをサポートするドライバーは必要ありません。
パケット結合をサポートするミニポート ドライバーは、ネットワーク アダプターで結合された受信パケットごとに ULONG64 カウンターをインクリメントする必要があります。 パケットは、受信フィルターと一致する場合、結合されます。このフィルターは、OID_RECEIVE_FILTER_SET_FILTER の OID メソッド要求を介して、上部のドライバーがミニポート ドライバーにダウンロードします。
ドライバーは、OID_PACKET_COALESCING_FILTER_MATCH_COUNT の OID クエリ要求を処理するとき、このカウンターの値を返します。
ミニポート ドライバーは、OID_PACKET_COALESCING_FILTER_MATCH_COUNT の OID クエリ要求を処理した後、カウンターをクリアする必要があります。 ミニポート ドライバーは、次の条件が満たされている場合にのみ、カウンターをクリアする必要があります。
ミニポート ドライバーは、OID_PNP_SET_POWER の OID セット要求を処理して、NdisDeviceStateD0 をフルパワー状態に復帰します。
NDIS は、ミニポート ドライバーの MiniportResetEx 関数を呼び出して、基になるネットワーク アダプターをリセットします。
パケット結合の詳細については、「NDIS パケット結合」を参照してください。
状態コードを返す
ミニポート ドライバーは、OID_PACKET_COALESCING_FILTER_MATCH_COUNT の OID メソッド要求の次の状態コードのいずれかを返します。
NDIS_STATUS_SUCCESS
OID 要求は正常に完了しました。
NDIS_STATUS_INVALID_LENGTH
情報バッファーが短すぎました。 ドライバーは DATA.SET_INFORMATION.BytesNeeded メンバー (NDIS_OID_REQUEST 構造内) を設定します。
NDIS_STATUS_FAILURE
その他の理由で要求に失敗しました。
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |