IF_SET_OBJECT función de devolución de llamada (ndis.h)

El ProviderSetObject función establece información asociada a una interfaz de red.

Sintaxis

IF_SET_OBJECT IfSetObject;

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

Parámetros

[in] ProviderIfContext

Identificador que identifica el área de contexto del proveedor de interfaz para la interfaz. El proveedor de interfaz pasó este identificador a NDIS en una llamada a . función NdisIfRegisterInterface.

[in] ObjectId

Identificador del objeto que es el destino de la solicitud establecida. Para obtener una lista de identificadores de objeto (OID) que se aplican a proveedores de interfaz, consulte identificadores de interfaz de red NDIS.

[in] InputBufferLength

Longitud, en bytes, del búfer al que pInputBuffer.

[in] pInputBuffer

Puntero a un búfer de entrada que especifica la información que el proveedor de interfaz debe usar para establecer los datos del objeto.

Valor devuelto

ProviderSetObject devuelve uno de los siguientes valores de estado:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	La operación se completó correctamente.
NDIS_STATUS_RESOURCES	Error en la operación debido a recursos insuficientes.
NDIS_STATUS_INVALID_PARAMETER	Error en la llamada porque algunos de los parámetros de entrada no eran válidos.
NDIS_STATUS_Xxx	Error en la llamada por algún otro motivo. Esta función puede propagar códigos de error de las funciones a las que llama o genera un código de error adecuado.

Observaciones

NDIS llama a la función ProviderSetObject de un proveedor de interfaz de red para establecer información asociada a una interfaz registrada por el proveedor. Para obtener una lista de los OID que se aplican a los proveedores de interfaz, consulte OID de interfaz de red NDIS.

Tenga en cuenta que actualmente no hay ningún OID establecido definido.

NDIS llama a ProviderSetObject en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Windows
encabezado de	ndis.h (incluya Ndis.h)
irQL	PASSIVE_LEVEL

Consulte también

NdisIfRegisterInterface