NdisFDirectOidRequest 関数 (ndis.h)
フィルター ドライバーは NdisFDirectOidRequest 関数を呼び出して、基になるドライバーに直接 OID 要求を転送するか、このような要求を生成します。
構文
NDIS_STATUS NdisFDirectOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
パラメーター
[in] NdisFilterHandle
フィルター モジュールを識別する NDIS ハンドル。 NDIS は FilterAttach 関数の呼び出しでフィルター ドライバーにハンドルを渡しました。
[in] OidRequest
特定のOID_Xxx コードで要求される操作を指定するNDIS_OID_REQUEST構造体へのポインター。 構造体では、OID クエリ、セット、またはメソッドの要求を指定できます。
戻り値
可能な戻り値の一覧については、 NdisDirectOidRequest 関数を参照してください。
注釈
NdisFDirectOidRequest 関数は、一般的な OID 要求には使用できません。 一般的な OID 要求の場合は、代わりに NdisFOidRequest 関数を使用します。 NdisFDirectOidRequest は、NDIS が直接 OID インターフェイスでの使用をサポートする OID にのみ使用できます。 たとえば、次の OID を使用できます。
OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SAフィルター ドライバーは、 NdisFDirectOidRequest を呼び出すことによって、基になるドライバーに直接 OID 要求を送信できます。
フィルター ドライバーは、基になるドライバーによって生成された直接 OID 要求をフィルター処理することもできます。 NDIS は FilterDirectOidRequest 関数を呼び出して、このような各要求を処理します。
NdisFDirectOidRequest がNDIS_STATUS_PENDINGを返す場合、基になるドライバーが OID 要求を完了した後、NDIS は FilterDirectOidRequestComplete 関数を呼び出します。 NdisFDirectOidRequest を呼び出すドライバーは、FilterDirectOidRequestComplete 関数を登録する必要があります。
ドライバーは、再起動、実行中、一時停止、または一時停止状態のときに NdisFDirectOidRequest を呼び出すことができます。
直接 OID 要求インターフェイスは、一般的な OID 要求インターフェイスと似ています。 一般的な要求の発行の詳細については、「 NdisFOidRequest」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.1 以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |