IF_SET_OBJECT fonction de rappel (ndis.h)

Article
02/26/2024

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 à Fonction NdisIfRegisterInterface .

[in] ObjectId

Identificateur de l’objet qui est la cible de la demande d’ensemble. 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.

[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 de l’objet.

Valeur retournée

ProviderSetObject 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 ProviderSetObject d’un fournisseur d’interface réseau pour définir les informations associées à 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.

Notez qu’aucun OID défini n’est actuellement défini.

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