IF_SET_OBJECT função de retorno de chamada (ndis.h)

  • Artigo

A função ProviderSetObject define informações associadas a um adaptador de rede.

Sintaxe

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

Um identificador que identifica a área de contexto do provedor de interface para a interface. O provedor de interface passou esse identificador para o NDIS em uma chamada para o Função NdisIfRegisterInterface .

[in] ObjectId

Um identificador para o objeto que é o destino da solicitação definida. Para obter uma lista de OIDs (identificadores de objeto) que se aplicam a provedores de interface, consulte OIDs da Interface de Rede do NDIS.

[in] InputBufferLength

O comprimento, em bytes, do buffer para o qual pInputBuffer aponta.

[in] pInputBuffer

Um ponteiro para um buffer de entrada que especifica as informações que o provedor de interface deve usar para definir os dados do objeto.

Retornar valor

ProviderSetObject retorna um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
 A operação foi concluída com sucesso.
NDIS_STATUS_RESOURCES
 A operação falhou devido a recursos insuficientes.
NDIS_STATUS_INVALID_PARAMETER
 A chamada falhou porque alguns dos parâmetros de entrada eram inválidos.
NDIS_STATUS_Xxx
 A chamada falhou por algum outro motivo. Essa função pode propagar códigos de erro das funções que chama ou gerar um código de erro apropriado.

Comentários

O NDIS chama a função ProviderSetObject de um provedor de interface de rede para definir informações associadas a uma interface que o provedor registrou. Para obter uma lista de OIDs que se aplicam a provedores de interface, consulte OIDs da Interface de Rede do NDIS.

Observe que atualmente não há nenhum OIDs definido definido.

O NDIS chama ProviderSetObject em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino Windows
Cabeçalho ndis.h (inclua Ndis.h)
IRQL PASSIVE_LEVEL

Confira também

NdisIfRegisterInterface