IF_QUERY_OBJECT Rückruffunktion (ndis.h)

Artikel
02/07/2025

Die ProviderQueryObject--Funktion ruft Informationen zu einer Netzwerkschnittstelle ab.

Syntax

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

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 Abfrageanforderung ist. Eine Liste der Objektbezeichner (OIDs), die für Schnittstellenanbieter gelten, finden Sie unter NDIS-Netzwerkschnittstellen-OIDs.

[in, out] pOutputBufferLength

Ein Zeiger auf eine von NDIS bereitgestellte Variable, in der NDIS die Länge des Ausgabepuffers bereitstellt. ProviderQueryObject- schreibt die Länge der Daten, die sie im Ausgabepuffer platziert.

[out] pOutputBuffer

Ein Zeiger auf einen von NDIS bereitgestellten Ausgabepuffer, in dem ProviderQueryObject die Antwort auf die Abfrageanforderung schreibt.

Rückgabewert

ProviderQueryObject 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 ProviderQueryObject--Funktion eines Netzwerkschnittstellenanbieters auf, um Informationen zu einer Schnittstelle abzurufen, die der Anbieter registriert hat. Eine Liste der OIDs, die für Schnittstellenanbieter gelten, finden Sie unter NDIS Network Interface OIDs.

NDIS ruft ProviderQueryObject- 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