IF_QUERY_OBJECT Rückruffunktion (ndis.h)

  • Artikel

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