IF_QUERY_OBJECT fonction de rappel (ndis.h)

Article
02/07/2025

La fonction ProviderQueryObject récupère des informations sur une interface réseau.

Syntaxe

IF_QUERY_OBJECT IfQueryObject;

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

Paramètres

[in] ProviderIfContext

Handle qui identifie la zone de contexte du fournisseur d’interface pour l’interface. Le fournisseur d’interface a passé ce handle à NDIS dans un appel au fonction NdisIfRegisterInterface.

[in] ObjectId

Identificateur de l’objet qui est la cible de la requête de requête. Pour obtenir la liste des identificateurs d’objet (OID) qui s’appliquent aux fournisseurs d’interface, consultez OID d’interface réseau NDIS.

[in, out] pOutputBufferLength

Pointeur vers une variable fournie par NDIS dans laquelle NDIS fournit la longueur de la mémoire tampon de sortie. ProviderQueryObject écrit la longueur des données qu’elle a placées dans la mémoire tampon de sortie.

[out] pOutputBuffer

Pointeur vers une mémoire tampon de sortie fournie par NDIS dans laquelle ProviderQueryObject écrit la réponse à la requête de requête.

Valeur de retour

ProviderQueryObject retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_RESOURCES	L’opération a échoué en raison de ressources insuffisantes.
NDIS_STATUS_INVALID_PARAMETER	L’appel a échoué, car certains paramètres d’entrée n’étaient pas valides.
NDIS_STATUS_xxx	L’appel a échoué pour une autre raison. Cette fonction peut propager des codes d’erreur à partir des fonctions qu’elle appelle ou générer un code d’erreur approprié.

Remarques

NDIS appelle la fonction ProviderQueryObject d’un fournisseur d’interface réseau pour obtenir des informations sur une interface inscrite par le fournisseur. Pour obtenir la liste des OID qui s’appliquent aux fournisseurs d’interface, consultez NDIS Network Interface OIDs.

NDIS appelle ProviderQueryObject à IRQL = PASSIVE_LEVEL.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Windows
d’en-tête	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

NdisIfRegisterInterface

Partager via