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 ステータス指示を発行するとき、次の手順に従う必要があります。
ミニポート ドライバーは、ネットワーク アダプター上の現在の 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 に設定します。
ミニポート ドライバーは、次の方法で NDIS_STATUS_INDICATION 構造を初期化します。
StatusCode メンバーは、NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS に設定する必要があります。
StatusBuffer メンバーは、NDIS_RECEIVE_QUEUE_PARAMETERS 構造へのポインターに設定する必要があります。 この構造には、NIC スイッチの現在有効なハードウェア機能が含まれています。
StatusBufferSize メンバーは sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS) に設定する必要があります。
ミニポート ドライバーは、NdisMIndicateStatusEx を呼び出すことによってステータス通知を発行します。 ドライバーは、StatusIndication パラメーターに NDIS_STATUS_INDICATION 構造へのポインターを渡す必要があります。
上位ドライバーは、NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS ステータス指示を使用し、ネットワーク アダプター上の現在の VM キュー パラメーターを決定できます。 または、これらのドライバーは、OID_RECEIVE_FILTER_QUEUE_PARAMETERS のオブジェクト識別子 (OID) クエリ要求を発行し、いつでもこれらのパラメーターを取得することもできます。
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ndis.h |