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

  • Artigo

A função ProviderQueryObject recupera informações sobre um adaptador de rede.

Sintaxe

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

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 de consulta. 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, out] pOutputBufferLength

Um ponteiro para uma variável fornecida pelo NDIS na qual o NDIS fornece o comprimento do buffer de saída. ProviderQueryObject grava o comprimento dos dados que ele colocou no buffer de saída.

[out] pOutputBuffer

Um ponteiro para um buffer de saída fornecido pelo NDIS no qual ProviderQueryObject grava a resposta na solicitação de consulta.

Retornar valor

ProviderQueryObject 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 ProviderQueryObject de um provedor de interface de rede para obter informações sobre 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.

O NDIS chama ProviderQueryObject 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