Share via


NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

ミニポート ドライバーは、現在有効な受信フィルター機能が変更されたとき、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行します。

このステータス指示は、NDIS 受信フィルターをサポートするミニポート ドライバーによってのみ作成する必要があります。

ミニポート ドライバーは、このステータス指示を作成するとき、NDIS_STATUS_INDICATION 構造の StatusBuffer メンバーを NDIS_RECEIVE_FILTER_CAPABILITIES 構造へのポインターに設定します。 ドライバーは、現在有効になっている受信フィルター機能を使用して、この構造を初期化します。

解説

NDIS 受信フィルターは、次の NDIS インターフェイスで使用されます。

ミニポート ドライバーは、次のいずれかの条件が true の場合、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行します。

  • 現在有効な受信フィルター機能は、単一のネットワーク アダプターで変更されます。 たとえば、受信フィルターは、独立系ハードウェア ベンダー (IHV) によって開発された管理アプリケーションを使用して有効または無効にすることができます。

  • 現在有効な受信フィルター機能は、MUX 中間ドライバーによって管理される負荷分散フェールオーバー (LBFO) チームに属する 1 つ以上のネットワーク アダプターに対して変更されます。 詳しくは、「NDIS MUX 中間ドライバー」をご覧ください。

ミニポート ドライバーは、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を発行するときに、次の手順に従います。

  1. ミニポートは、ネットワーク アダプターで現在有効になっている受信フィルター機能を使用して、NDIS_RECEIVE_FILTER_CAPABILITIES 構造を初期化します。

    ミニポート ドライバーは、ヘッダー メンバーを初期化したとき、ヘッダーメンバーを NDIS_OBJECT_TYPE_DEFAULT に設定します。 ミニポート ドライバーは、ヘッダーリビジョン メンバーを NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 に設定し、サイズ メンバーを NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2 に設定します。

  2. ミニポート ドライバーは、次の方法でステータス指示の NDIS_STATUS_INDICATION 構造を初期化します。

    • StatusCode メンバーは、NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES に設定する必要があります。

    • StatusBuffer メンバーは、NDIS_RECEIVE_FILTER_CAPABILITIES 構造のアドレスに設定する必要があります。

    • StatusBufferSize メンバーを sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES) に設定する必要があります。

  3. ミニポート ドライバーは、NdisMIndicateStatusEx を呼び出すことによってステータス指示を発行します。 ドライバーは、StatusIndication パラメーターに NDIS_STATUS_INDICATION 構造へのポインターを渡す必要があります。

上にあるドライバーは、ネットワーク アダプターの 現在有効な受信フィルター機能を決定する NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES ステータス指示を使用できます。 または、これらのドライバーは、任意の時点で現在有効な受信フィルター機能を取得する OID_RECEIVE_FILTER_CURRENT_CAPABILITIES の OID クエリ要求を発行することもできます。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

Ndis.h (Ndis.h を含む)

関連項目


NdisMIndicateStatusEx

NDIS_STATUS_INDICATION

NDIS_RECEIVE_FILTER_CAPABILITIES

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES