FILTER_DIRECT_OID_REQUEST コールバック関数 (ndis.h)
NDIS は、フィルター ドライバーの FilterDirectOidRequest 関数を呼び出して、指定されたフィルター モジュールに関連付けられている直接 OID 要求を処理します。
構文
FILTER_DIRECT_OID_REQUEST FilterDirectOidRequest;
NDIS_STATUS FilterDirectOidRequest(
[in] NDIS_HANDLE FilterModuleContext,
[in] PNDIS_OID_REQUEST OidRequest
)
{...}
パラメーター
[in] FilterModuleContext
この要求のターゲットであるフィルター モジュールのコンテキスト領域へのハンドル。 フィルター ドライバーは、 FilterAttach 関数でこのコンテキスト領域を作成および初期化しました。
[in] OidRequest
OID_Xx コードを含む、要求された操作を指定するNDIS_OID_REQUEST構造体へのポインター。 構造体では、クエリ要求またはセット要求のいずれかを指定できます
戻り値
FilterDirectOidRequest は、次のいずれかの状態値を返します。
リターン コード | 説明 |
---|---|
|
FilterDirectOidRequest は、このフィルター モジュールのフィルター ドライバーのクエリまたは設定操作を正常に完了しました。 |
|
フィルター ドライバーは、要求を非同期的に完了します。 ドライバーが要求を完了したら、 を呼び出す必要があります。要求が完了したことを NDIS に通知する NdisFDirectOidRequestComplete 関数。 |
|
OidRequest が指定した要求が無効であるか、認識されませんでした。 |
|
FilterDirectOidRequest は OID をサポートしていません。OID は省略可能です。 |
|
OidRequest が指定したバッファーが小さすぎて、要求されたデータを保持できませんでした。 |
|
クエリ操作の場合、NDIS_OID_REQUEST構造体の InformationBufferLength メンバーは、指定された OID に必要な長さと一致しません。 FilterDirectOidRequest は、NDIS_OID_REQUEST構造体の BytesNeeded メンバーに必要なバッファー サイズ (バイト単位) を返しました。 |
|
設定操作の場合、NDIS_OID_REQUEST構造体の InformationBuffer メンバーに指定されたデータが、指定された OID に対して無効でした。 |
|
FilterDirectOidRequest は要求された情報を収集しようとしましたが、失敗しました。 |
|
リソースが不足しているため、FilterDirectOidRequest が失敗しました。 |
|
N 上記の戻り値のいずれかが適用されます。 フィルター ドライバーは、エラーの理由を指定するパラメーターを使用して NdisWriteErrorLogEntry 関数を呼び出す必要があります。 |
注釈
FilterDirectOidRequest は省略可能な関数です。 フィルター ドライバーが直接 OID 要求を使用しない場合、NdisFRegisterFilterDriver 関数を呼び出すときに、この関数のエントリ ポイントを NULL に設定できます。 フィルター ドライバーで が定義されている場合、 FilterDirectOidRequestComplete 関数は、 FilterDirectOidRequest 関数を提供する必要があります。
NDIS は、フィルター ドライバーの FilterDirectOidRequest 関数を呼び出して、上にあるドライバーによって生成された直接 OID 要求を処理します。 フィルター ドライバーは、 NdisFDirectOidRequest 関数を呼び出すことによって、基になるドライバーにこのような要求を転送できます。 オプションとして、フィルター ドライバーは要求を転送せずにすぐに要求を完了することもできます。
ドライバーが NdisFDirectOidRequest を呼び出す前に、ドライバーは NDIS_OID_REQUEST 構造体を割り当て、 を呼び出して要求情報を新しい構造体に転送する必要があります。 NdisAllocateCloneOidRequest 関数。
要求を同期的に完了するために、フィルター ドライバーはNDIS_STATUS_SUCCESSまたはエラー状態を返します。 ドライバーがNDIS_STATUS_PENDINGを返す場合は、 を呼び出す必要があります。要求が完了したことを NDIS に通知する NdisFDirectOidRequestComplete 関数。
クエリ操作の場合、 FilterDirectOidRequest は InformationBuffer メンバーで要求された情報を返し、NDIS_OID_REQUEST構造体の BytesWritten メンバーの変数を、返される情報の量に設定します。 基になるドライバーは、フィルター ドライバーが NdisFDirectOidRequest で要求を渡した場合にこれを行います。
設定操作の場合 、FilterDirectOidRequest は、NDIS_OID_REQUEST構造体の InformationBuffer メンバー内のデータを使用して、指定された OID に必要な情報を設定できます。 この場合、 FilterDirectOidRequest は BytesRead の変数を、使用した指定されたデータの量に設定します。 基になるドライバーは、フィルター ドライバーが NdisFDirectOidRequest で要求を渡した場合に、この方法で BytesRead を設定します。
NDIS は、他の OID 要求と共に FilterDirectOidRequest に送信する要求をシリアル化しません。 FilterOidRequest または FilterDirectOidRequest に送信される他の要求が未処理の場合、フィルター ドライバーは FilterDirectOidRequest への複数の呼び出しを処理できる必要があります。
NDIS は、IRQL <= DISPATCH_LEVELで FilterDirectOidRequest を呼び出します。
例
FilterDirectOidRequest 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数型のセットが用意されています。 関数の種類を使用して関数を宣言すると、 ドライバーのコード分析、 静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。たとえば、" MyDirectOidRequest" という名前の FilterDirectOidRequest 関数を定義するには、次のコード例に示すように 、FILTER_DIRECT_OID_REQUEST 型を使用します。
FILTER_DIRECT_OID_REQUEST MyDirectOidRequest;
次に、次のように関数を実装します。
_Use_decl_annotations_
NDIS_STATUS
MyDirectOidRequest(
NDIS_HANDLE FilterModuleContext,
PNDIS_OID_REQUEST OidRequest
)
{...}
FILTER_DIRECT_OID_REQUEST関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールを実行するときにエラーをより正確に識別するには、 Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations注釈を使用すると、ヘッダー ファイル内のFILTER_DIRECT_OID_REQUEST関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「NDIS ドライバーの関数 ロール型を使用して関数を宣言する」を参照してください。
Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | NDIS 6.1 以降でサポートされています。 |
対象プラットフォーム | Windows |
ヘッダー | ndis.h (Ndis.h を含む) |
IRQL | <= DISPATCH_LEVEL |
こちらもご覧ください
FilterDirectOidRequestComplete NdisFDirectOidRequestCompleteフィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示