IF_SET_OBJECT fonction de rappel (ndis.h)

Article
02/07/2025

La fonction ProviderSetObject définit les informations associées à une interface réseau.

Syntaxe

IF_SET_OBJECT IfSetObject;

NDIS_STATUS() IfSetObject(
  [in] NDIS_HANDLE ProviderIfContext,
  [in] NET_IF_OBJECT_ID ObjectId,
  [in] ULONG InputBufferLength,
  [in] PVOID pInputBuffer
)
{...}

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 set. Pour obtenir la liste des identificateurs d’objet (OID) qui s’appliquent aux fournisseurs d’interface, consultez OID d’interface réseau NDIS.

[in] InputBufferLength

Longueur, en octets, de la mémoire tampon vers laquelle pInputBuffer pointe vers.

[in] pInputBuffer

Pointeur vers une mémoire tampon d’entrée qui spécifie les informations que le fournisseur d’interface doit utiliser pour définir les données d’objet.

Valeur de retour

ProviderSetObject 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 ProviderSetObject d’un fournisseur d’interface réseau pour définir des informations associées à une interface inscrite par le fournisseur. Pour obtenir la liste des OID qui s’appliquent aux fournisseurs d’interface, consultez NDIS Network Interface OIDs.

Notez qu’il n’existe actuellement aucun OID défini.

NDIS appelle ProviderSetObject à 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