IF_QUERY_OBJECT fonction de rappel (ndis.h)

Article
02/26/2024

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 à 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’il 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 demande de requête.

Valeur retournée

ProviderQueryObject retourne l’une des valeurs status suivantes :

Code de retour	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 OID d’interface réseau NDIS.

NDIS appelle ProviderQueryObject à IRQL = PASSIVE_LEVEL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Windows
En-tête	ndis.h (inclure Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

NdisIfRegisterInterface

Partager via