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

  • [アーティクル]

ProviderSetObject 関数は、ネットワーク インターフェイスに関連付けられている情報を設定します。

構文

IF_SET_OBJECT IfSetObject;

NDIS_STATUS() IfSetObject(
  [in] NDIS_HANDLE ProviderIfContext,
  [in] NET_IF_OBJECT_ID ObjectId,
  [in] ULONG InputBufferLength,
  [in] PVOID pInputBuffer
)
{...}

パラメーター

[in] ProviderIfContext

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

[in] ObjectId

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

[in] InputBufferLength

pInputBuffer が指すバッファーの長さ (バイト単位)。

[in] pInputBuffer

インターフェイス プロバイダーがオブジェクト データの設定に使用する必要がある情報を指定する入力バッファーへのポインター。

戻り値

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

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

注釈

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

現在、セット OID は定義されていないことに注意してください。

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

要件

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

こちらもご覧ください

NdisIfRegisterInterface