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 は、ネットワーク インターフェイス プロバイダーの ProviderSetObject 関数を呼び出して、プロバイダーが登録したインターフェイスに関連付けられている情報を設定します。 インターフェイス プロバイダーに適用される OID の一覧については、「 NDIS ネットワーク インターフェイス OID」を参照してください。
現在、セット OID は定義されていないことに注意してください。
NDIS は、IRQL = PASSIVE_LEVELで ProviderSetObject を 呼び出します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | NDIS 6.0 以降でサポートされています。 |
対象プラットフォーム | Windows |
ヘッダー | ndis.h (Ndis.h を含む) |
IRQL | PASSIVE_LEVEL |