IF_SET_OBJECT Rückruffunktion (ndis.h)

Artikel
02/07/2025

Die ProviderSetObject--Funktion legt Informationen fest, die einer Netzwerkschnittstelle zugeordnet sind.

Syntax

IF_SET_OBJECT IfSetObject;

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

Parameter

[in] ProviderIfContext

Ein Handle, das den Kontextbereich des Schnittstellenanbieters für die Schnittstelle identifiziert. Der Schnittstellenanbieter hat dieses Handle in einem Aufruf an NDIS übergeben. NdisIfRegisterInterface Funktion.

[in] ObjectId

Ein Bezeichner für das Objekt, das das Ziel der Setanforderung ist. Eine Liste der Objektbezeichner (OIDs), die für Schnittstellenanbieter gelten, finden Sie unter NDIS-Netzwerkschnittstellen-OIDs.

[in] InputBufferLength

Die Länge des Puffers in Bytes, auf den pInputBuffer verweist.

[in] pInputBuffer

Ein Zeiger auf einen Eingabepuffer, der die Informationen angibt, die der Schnittstellenanbieter zum Festlegen der Objektdaten verwenden soll.

Rückgabewert

ProviderSetObject- gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_RESOURCES	Fehler beim Vorgang aufgrund unzureichender Ressourcen.
NDIS_STATUS_INVALID_PARAMETER	Fehler beim Aufruf, da einige der Eingabeparameter ungültig waren.
NDIS_STATUS_Xxx	Der Anruf ist aus einem anderen Grund fehlgeschlagen. Diese Funktion kann Fehlercodes aus den Von ihr aufgerufenen Funktionen weitergeben oder einen entsprechenden Fehlercode generieren.

Bemerkungen

NDIS ruft die ProviderSetObject--Funktion eines Netzwerkschnittstellenanbieters auf, um Informationen festzulegen, die einer Schnittstelle zugeordnet sind, die der Anbieter registriert hat. Eine Liste der OIDs, die für Schnittstellenanbieter gelten, finden Sie unter NDIS Network Interface OIDs.

Beachten Sie, dass derzeit keine festgelegten OIDs definiert sind.

NDIS ruft ProviderSetObject- bei IRQL = PASSIVE_LEVEL auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Zielplattform-	Fenster
Header-	ndis.h (include Ndis.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

NdisIfRegisterInterface

Freigeben über