IF_QUERY_OBJECT Rückruffunktion (ndis.h)

Artikel
02/26/2024

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

[in] ObjectId

Ein Bezeichner für das Objekt, das das Ziel der Abfrageanforderung ist. Eine Liste der Objektbezeichner (Object Identifiers, 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 in den Ausgabepuffer eingefügt wurden.

[out] pOutputBuffer

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

Rückgabewert

ProviderQueryObject 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 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-Netzwerkschnittstellen-OIDs.

NDIS ruft ProviderQueryObject 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 (include Ndis.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

NdisIfRegisterInterface

Freigeben über