Compartir a través de

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

  • Artículo

La función ProviderQueryObject recupera información sobre una interfaz de red.

Sintaxis

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

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 de consulta. Para obtener una lista de identificadores de objeto (OID) que se aplican a los proveedores de interfaz, consulte NDIS Network Interface OIDs(Identificadores de interfaz de red NDIS).

[in, out] pOutputBufferLength

Puntero a una variable proporcionada por NDIS en la que NDIS proporciona la longitud del búfer de salida. ProviderQueryObject escribe la longitud de los datos que coloca en el búfer de salida.

[out] pOutputBuffer

Puntero a un búfer de salida proporcionado por NDIS en el que ProviderQueryObject escribe la respuesta a la solicitud de consulta.

Valor devuelto

ProviderQueryObject devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
 La operación se ha completado 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.

Comentarios

NDIS llama a la función ProviderQueryObject de un proveedor de interfaz de red para obtener información sobre una interfaz registrada por el proveedor. Para obtener una lista de los OID que se aplican a los proveedores de interfaz, consulte NDIS Network Interface OIDs( OID de interfaz de red de NDIS).

NDIS llama a ProviderQueryObject en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino Windows
Encabezado ndis.h (incluya Ndis.h)
IRQL PASSIVE_LEVEL

Consulte también

NdisIfRegisterInterface