NdisFOidRequest 関数 (ndis.h)

  • [アーティクル]

フィルター ドライバーは NdisFOidRequest 関数を呼び出して、基になるドライバーに OID 要求を転送するか、そのような要求を生成します。

構文

NDIS_STATUS NdisFOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

パラメーター

[in] NdisFilterHandle

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

[in] OidRequest

特定のOID_XXX コードで要求された操作を指定するNDIS_OID_REQUEST構造体へのポインター。 構造体では、クエリ、セット、またはメソッドの要求を指定できます。 OID の詳細については、「 NDIS OID」を参照してください。

戻り値

NdisOidRequest 関数を参照してください。

注釈

フィルター ドライバーは、 NdisFOidRequest を呼び出すことによって、基になるドライバーに OID 要求を生成できます。

フィルター ドライバーは、基になるドライバーによって生成された OID 要求をフィルター処理することもできます。 NDIS は、 FilterOidRequest 関数を呼び出して、このような各要求を処理します。

NdisFOidRequest がNDIS_STATUS_PENDINGを返す場合、基になるドライバーが OID 要求を完了した後、NDIS は FilterOidRequestComplete 関数を呼び出します。

NdisFOidRequest がNDIS_STATUS_SUCCESSを返す場合は、OidRequest パラメーターのNDIS_OID_REQUEST構造体でクエリ要求の結果を返します。

フィルター ドライバーがNDIS_OID_REQUEST構造体の [ヘッダー] フィールドの [種類] フィールドと [サイズ] フィールドに無効な値を渡した場合、NdisFOidRequest はNDIS_STATUS_INVALID_PARAMETERを返すことができます。

ドライバーは、再起動、実行中、一時停止、または一時停止状態のときに NdisFOidRequest を呼び出すことができます。

要件

要件 値
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_OID_Function(ndis)

こちらもご覧ください

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest