функция обратного вызова IF_SET_OBJECT (ndis.h)

Статья
02/07/2025

Функция 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

Идентификатор объекта, который является целевым объектом запроса набора. Список идентификаторов объектов (OID), применяемых к поставщикам интерфейсов, см. в сетевых интерфейсов NDIS.

[in] InputBufferLength

Длина в байтах буфера, на который pInputBuffer указывает.

[in] pInputBuffer

Указатель на входной буфер, указывающий сведения, которые поставщик интерфейса должен использовать для задания данных объекта.

Возвращаемое значение

ProviderSetObject возвращает одно из следующих значений состояния:

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	Операция успешно завершена.
NDIS_STATUS_RESOURCES	Операция завершилась ошибкой из-за нехватки ресурсов.
NDIS_STATUS_INVALID_PARAMETER	Сбой вызова, так как некоторые входные параметры были недопустимыми.
NDIS_STATUS_Xxx	Вызов произошел сбоем по какой-либо другой причине. Эта функция может распространять коды ошибок из вызываемой функции или создавать соответствующий код ошибки.

Замечания

NDIS вызывает функцию поставщика сетевого интерфейса ProviderSetObject, чтобы задать сведения, связанные с интерфейсом, зарегистрированным поставщиком. Список OID, применяемых к поставщикам интерфейсов, см. в разделе сетевых интерфейсов NDIS.

Обратите внимание, что в настоящее время не определены наборы OID.

NDIS вызывает ProviderSetObject в IRQL = PASSIVE_LEVEL.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Виндоус
заголовка	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

См. также

NdisIfRegisterInterface

Поделиться через