VM キュー パラメーターの取得と更新

上位のドライバーは、VM キューが割り当てられた後に VM キューの構成パラメーターを設定できます。 また、上位ドライバーまたはアプリケーションは、キューの現在のパラメーターと、キューに設定されているフィルターのパラメーターを取得できます。

キューの現在の設定パラメーターを変更するには、上位ドライバーは OID_RECEIVE_FILTER_QUEUE_PARAMETERS の OID セット要求を使用することができます。 上位ドライバーは、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーの NDIS_RECEIVE_QUEUE_PARAMETERS へのポインターを提供します。

NDIS_RECEIVE_QUEUE_PARAMETERS 構造は、OID_RECEIVE_FILTER_ALLOCATE_QUEUE OID と OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID で使用されます。 キューの割り当てについての詳細は、「VM キューの割り当て」を参照してください。

キューの現在の設定パラメーターを得るには、上位ドライバーは OID_RECEIVE_FILTER_QUEUE_PARAMETERS の OID メソッド要求を使用することができます。 NDIS_OID_REQUEST 構造の InformationBuffer メンバーには、初期状態では NDIS_RECEIVE_QUEUE_PARAMETERS 構造へのポインターを持ち、NDIS_RECEIVE_QUEUE_ID 型のキュー識別子を持ちます。 OID メソッド要求から正常に戻った後、 NDIS_OID_REQUEST 構造の InformationBuffer メンバーには、 NDIS_RECEIVE_QUEUE_PARAMETERS 構造へのポインターが含まれています。

NDIS は、ミニポート ドライバーのメソッド要求を処理します。 したがって、ミニポート ドライバーの OID_RECEIVE_FILTER_QUEUE_PARAMETERS メソッド OID 要求は要求されません。 NDIS は、OID_RECEIVE_FILTER_ALLOCATE_QUEUE および OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 要求から受信したデータの内部キャッシュから情報を取得しています。

受信キュー上のフィルターの現在の構成パラメーターを取得するには、上位ドライバーは、OID_RECEIVE_FILTER_PARAMETERS メソッド OID 要求を使用できます。 この NDIS_OID_REQUEST 構造の InformationBuffer メンバーは、最初に NDIS_RECEIVE_FILTER_PARAMETERS 構造へのポインターを含んでいます。 NDIS は、入力構造体の FilterId メンバーを使用して、フィルターを識別します。 メソッド要求から正常に戻った後、NDIS_OID_REQUEST 構造の InformationBuffer のメンバーには、 更新された NDIS_RECEIVE_FILTER_PARAMETERS 構造へのポインターが含まれます。

NDIS は、ミニポート ドライバーの OID_RECEIVE_FILTER_PARAMETERS メソッド OID 要求を処理します。 NDIS は、OID_RECEIVE_FILTER_Standard Edition T_FILTER OID リクエストから受信したデータの内部キャッシュから情報を取得しました。

上位ドライバーは、OID_RECEIVE_FILTER_PARAMETERS メソッド OID 要求を使用して、受信キュー上のフィルターの構成パラメーターを取得できます。

上位ドライバーは、以前の OID_RECEIVE_FILTER_SET_FILTER メソッド OID 要求、または OID_RECEIVE_FILTER_ENUM_FILTERS OID 要求からフィルター識別子を取得しました。 OID_RECEIVE_FILTER_SET_FILTER 要求を使用できるのはドライバーだけです。

アプリケーションは、OID_RECEIVE_FILTER_ENUM_FILTERS OID 要求からフィルター識別子を取得しました。