Share via

NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

  • [アーティクル]

NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示は、現在の仮想マシン (VM) キュー パラメーターがネットワーク アダプターで変更されたことを NDIS および上位ドライバーに示します。

解説

ミニポート ドライバーは、現在の VM キューのパラメーターがネットワーク アダプターで変更されたとき、NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示を発行する必要があります。 VM キュー パラメーターは、次のいずれかの条件に該当すると変化する可能性があります。

  • VM キュー パラメーターは、独立系ハードウェア ベンダー (IHV) によって開発された管理アプリケーションによって変更されます。

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

ミニポート ドライバーが NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示を発行するとき、次の手順に従う必要があります。

  1. ミニポート ドライバーは、ネットワーク アダプター上の現在の VM キュー パラメーターを使って NDIS_RECEIVE_QUEUE_PARAMETERS 構造を初期化します。 さらに、ドライバーは、適切な NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED フラグを使用して、この構造のフラグ メンバーを設定し、変更された NDIS_RECEIVE_QUEUE_PARAMETERS メンバー値を報告する必要もあります。

    注 NDIS 6.30 以降、ミニポート ドライバーは、InterruptCoalescingDomainId メンバーへの変更を報告するため、NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示のみ発行できます。

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

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

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

    • StatusBuffer メンバーは、NDIS_RECEIVE_QUEUE_PARAMETERS 構造へのポインターに設定する必要があります。 この構造には、NIC スイッチの現在有効なハードウェア機能が含まれています。

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

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

上位ドライバーは、NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示を使用し、ネットワーク アダプター上の現在の VM キュー パラメーターを決定できます。 または、これらのドライバーは、OID_RECEIVE_FILTER_QUEUE_PARAMETERS のオブジェクト識別子 (OID) クエリ要求を発行し、いつでもこれらのパラメーターを取得することもできます。

要件

バージョン

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

ヘッダー

 Ndis.h

関連項目

NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS