NdisFDirectOidRequest 関数 (ndis.h)

[アーティクル]
08/07/2023

フィルタードライバーは 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