IF_QUERY_OBJECT Rückruffunktion (ndis.h)
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der Vorgang ist aufgrund unzureichender Ressourcen fehlgeschlagen. |
|
Der Aufruf ist fehlgeschlagen, weil einige der Eingabeparameter ungültig waren. |
|
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 |