IF_SET_OBJECT Rückruffunktion (ndis.h)

  • Artikel

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 die NDIS übergeben. NdisIfRegisterInterface-Funktion .

[in] ObjectId

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

[in] InputBufferLength

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

[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 status Werte zurück:

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

Hinweise

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

Beachten Sie, dass derzeit keine festgelegten OIDs definiert sind.

NDIS ruft ProviderSetObject unter IRQL = PASSIVE_LEVEL auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt in NDIS 6.0 und höher.
Zielplattform Windows
Kopfzeile ndis.h (einschließlich Ndis.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

NdisIfRegisterInterface