функция обратного вызова 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

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

[in] InputBufferLength

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

[in] pInputBuffer

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

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

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

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

Комментарии

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

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

NDIS вызывает ProviderSetObject по адресу IRQL = PASSIVE_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа Windows
Header ndis.h (включая Ndis.h)
IRQL PASSIVE_LEVEL

См. также раздел

NdisIfRegisterInterface