Share via


NdisFSynchronousOidRequest 関数 (ndis.h)

フィルター ドライバーは、NdisFSynchronousOidRequest 関数を呼び出して、新しい同期 OID 要求を生成し、基になるドライバーに発行します。

この関数は、NDIS 6.81 以降でサポートされています。

構文

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

パラメーター

[in] NdisFilterModuleHandle

フィルター モジュールを識別する NDIS ハンドル。 NDIS は FilterAttach 関数の呼び出しでフィルター ドライバーにハンドルを渡しました。

[in] OidRequest

特定の OID_Xxx コードで要求される操作を指定する NDIS_OID_REQUEST 構造体へのポインター。 構造体では、OID クエリ、セット、またはメソッドの要求を指定できます。

戻り値

この関数は NdisDirectOidRequest と同じ値を返しますが、この関数からNDIS_STATUS_PENDINGが返されることはありません。

注釈

NdisFSynchronousOidRequest 関数は、一般的な OID 要求には使用できません。 一般的な OID 要求の場合は、代わりに NdisFOidRequest 関数を使用します。 NdisFSynchronousOidRequest は、NDIS が同期 OID インターフェイスでの使用をサポートする OID にのみ使用できます。 ほとんどのフィルター ドライバーでは、 NdisFSynchronousOidRequest を呼び出す必要はありません。

フィルター ドライバーによって送信された同期 OID 要求が完了するまで、フィルター ドライバーは FilterDetach を完了できません。

フィルター ドライバーは、NdisFSynchronousOidRequest を呼び出すために FilterOidRequestCompleteFilterDirectOidRequestCompleteFilterSynchronousOidRequest、または FilterSynchronousOidRequestComplete を実装する必要はありません。 その名前が示すように、同期 OID 要求は常に同期的に完了するため、非同期コールバックはありません。

要件

要件
サポートされている最小のクライアント Windows 10 バージョン 1709
対象プラットフォーム ユニバーサル
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

NDIS 6.80 の同期 OID 要求インターフェイス