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) |