NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
ミニポート ドライバーは、現在有効な受信フィルター機能が変更されたとき、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行します。
注 このステータス指示は、NDIS 受信フィルターをサポートするミニポート ドライバーによってのみ作成する必要があります。
ミニポート ドライバーは、このステータス指示を作成するとき、NDIS_STATUS_INDICATION 構造の StatusBuffer メンバーを NDIS_RECEIVE_FILTER_CAPABILITIES 構造へのポインターに設定します。 ドライバーは、現在有効になっている受信フィルター機能を使用して、この構造を初期化します。
解説
NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます。
NDIS Packet Coalescing。 このインターフェイスで受信フィルターを使用する方法の詳細については、「パケット結合受信フィルターの管理」を参照してください。
シングル ルート I/O 仮想化 (SR-IOV)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「仮想ポートでの受信フィルターの設定」を参照してください。
仮想マシン キュー (VMQ)。 このインターフェイスで受信フィルターを使用する方法の詳細については、「VMQ フィルターの設定とクリア」を参照してください。
ミニポート ドライバーは、次のいずれかの条件が true の場合、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行します。
現在有効な受信フィルター機能は、単一のネットワーク アダプターで変更されます。 たとえば、受信フィルターは、独立系ハードウェア ベンダー (IHV) によって開発された管理アプリケーションを使用して有効または無効にすることができます。
現在有効な受信フィルター機能は、MUX 中間ドライバーによって管理される負荷分散フェールオーバー (LBFO) チームに属する 1 つ以上のネットワーク アダプターに対して変更されます。 詳しくは、「NDIS MUX 中間ドライバー」をご覧ください。
ミニポート ドライバーは、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行するときに、次の手順に従います。
ミニポートは、ネットワーク アダプターで現在有効になっている受信フィルター機能を使用して、NDIS_RECEIVE_FILTER_CAPABILITIES 構造を初期化します。
ミニポート ドライバーは、ヘッダー メンバーを初期化したとき、ヘッダーの型メンバーを NDIS_OBJECT_TYPE_DEFAULT に設定します。 ミニポート ドライバーは、ヘッダーのリビジョン メンバーを NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 に設定し、サイズ メンバーを NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2 に設定します。
ミニポート ドライバーは、次の方法でステータス指示の NDIS_STATUS_INDICATION 構造を初期化します。
StatusCode メンバーは、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES に設定する必要があります。
StatusBuffer メンバーは、NDIS_RECEIVE_FILTER_CAPABILITIES 構造のアドレスに設定する必要があります。
StatusBufferSize メンバーを
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)に設定する必要があります。
ミニポート ドライバーは、NdisMIndicateStatusEx を呼び出すことによってステータス指示を発行します。 ドライバーは、StatusIndication パラメーターに NDIS_STATUS_INDICATION 構造へのポインターを渡す必要があります。
注 上にあるドライバーは、ネットワーク アダプターの 現在有効な受信フィルター機能を決定する NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を使用できます。 または、これらのドライバーは、任意の時点で現在有効な受信フィルター機能を取得する OID_RECEIVE_FILTER_CURRENT_CAPABILITIES の OID クエリ要求を発行することもできます。
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ndis.h (Ndis.h を含む) |