フィルター モジュール状態表示

  • [アーティクル]

フィルター ドライバーは、基になるドライバーがステータスを 報告するときに NDIS が呼び出す FilterStatus 関数を提供できます。 フィルター ドライバーは、ステータス表示を開始することもできます。

次の図は、フィルター処理されたステータスの表示を示しています。

Diagram illustrating a filtered status indication.

NDIS は、基になるドライバーが状態表示関数 (NdisMIndicateStatusEx または NdisFIndicateStatus) を呼び出した後、フィルター ドライバーの FilterStatus 関数を呼び出します。 ミニポート ドライバーからの状態を示す方法の詳細については、「アダプターの状態の表示」 を参照してください。

フィルター ドライバーは、フィルター処理されたステータス表示を基になるドライバーに譲渡するためにFilterStatus 関数で NdisFIndicateStatus を呼び出します。 フィルター ドライバーは、(NdisFIndicateStatus を呼び出すことなく) ステータス表示をフィルター処理したり、NdisFIndicateStatus を呼び出す前に示された状態を変更したりできます。

状態表示を開始するには、フィルター ドライバーは、FilterStatus の前の呼び出しをすることなく NdisFIndicateStatus を呼び出します。

この場合、フィルター ドライバーは、FilterAttach 関数の NdisFilterHandle パラメーターに渡されたハンドルに SourceHandle メンバーを設定する必要があります。 状態表示が OID リクエストに関連付けられている場合、フィルタードライバーは DestinationHandle メンバーと RequestId メンバーを設定して、NDIS が特定のプロトコル バインディングに状態表示を提供できるようにします。

フィルター ドライバーが NdisFIndicateStatus を呼び出した後、NDIS は、次の上位ドライバーの状態関数 (ProtocolStatusEx または FilterStatus) を呼び出します。