次の方法で共有

IF_QUERY_OBJECT コールバック関数 (ndis.h)

  • [アーティクル]

ProviderQueryObject 関数は、ネットワーク インターフェイスに関する情報を取得します。

構文

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

パラメーター

[in] ProviderIfContext

インターフェイス プロバイダーのインターフェイスのコンテキスト領域を識別するハンドル。 インターフェイス プロバイダーは、このハンドルを NDIS への呼び出しで渡しました。NdisIfRegisterInterface 関数を します。

[in] ObjectId

クエリ要求のターゲットであるオブジェクトの識別子。 インターフェイス プロバイダーに適用されるオブジェクト識別子 (OID) の一覧については、「NDIS ネットワーク インターフェイス OIDを参照してください。

[in, out] pOutputBufferLength

NDIS が出力バッファーの長さを提供する NDIS 提供の変数へのポインター。 ProviderQueryObject は、出力バッファーに格納されたデータの長さを書き込みます。

[out] pOutputBuffer

ProviderQueryObject がクエリ要求に応答を書き込む NDIS 提供の出力バッファーへのポインター。

戻り値

ProviderQueryObject は、次のいずれかの状態値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
 操作が正常に完了しました。
NDIS_STATUS_RESOURCES
 リソースが不足しているため、操作に失敗しました。
NDIS_STATUS_INVALID_PARAMETER
 一部の入力パラメーターが無効であるため、呼び出しに失敗しました。
NDIS_STATUS_xxx
 他の理由で呼び出しが失敗しました。 この関数は、呼び出す関数からエラー コードを伝達したり、適切なエラー コードを生成したりできます。

備考

NDIS は、ネットワーク インターフェイス プロバイダーの ProviderQueryObject 関数を呼び出して、プロバイダーが登録したインターフェイスに関する情報を取得します。 インターフェイス プロバイダーに適用される OID の一覧については、「NDIS ネットワーク インターフェイス OID 参照してください。

NDIS は、IRQL = PASSIVE_LEVEL で ProviderQueryObject 呼び出します。

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.0 以降でサポートされています。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndis.h (Ndis.h を含む)
IRQL PASSIVE_LEVEL

関連項目

NdisIfRegisterInterface の