MINIPORT_OID_REQUEST Rückruffunktion (ndis.h)

Artikel
02/07/2025

NDIS ruft die MiniportOidRequest Funktion eines Miniporttreibers auf, um eine OID-Anforderung zum Abfragen oder Festlegen von Informationen im Treiber zu verarbeiten.

Hinweis Sie müssen die Funktion mithilfe des MINIPORT_OID_REQUEST Typs deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".

Syntax

MINIPORT_OID_REQUEST MiniportOidRequest;

NDIS_STATUS MiniportOidRequest(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OID_REQUEST OidRequest
)
{...}

Parameter

[in] MiniportAdapterContext

Ein Handle zu einem Kontextbereich, den der Miniporttreiber in seiner MiniportInitializeEx--Funktion zugewiesen hat. Der Miniporttreiber verwendet diesen Kontextbereich, um Zustandsinformationen für einen Miniportadapter beizubehalten.

[in] OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST Struktur, die sowohl den Puffer als auch das Anforderungspaket für den Miniporttreiber enthält, der verarbeitet werden soll. Je nach Anforderung gibt der Treiber angeforderte Informationen in der bereitgestellten Struktur zurück.

Rückgabewert

MiniportOidRequest- kann einen der folgenden Statuswerte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Miniporttreiber hat entweder die Daten wie angefordert festgelegt oder abgerufen.
NDIS_STATUS_PENDING	Der Miniporttreiber führt die Anforderung asynchron aus. Nachdem der Miniporttreiber die gesamte Verarbeitung abgeschlossen hat, muss er die NdisMOidRequestComplete Funktion, um NDIS darüber zu informieren, dass die Anforderung abgeschlossen ist.
NDIS_STATUS_INVALID_OID	Die Anforderung, die bei OidRequestangegeben wurde, ist ungültig oder nicht erkannt.
NDIS_STATUS_NOT_SUPPORTED	Die Anforderung, die bei OidRequestangegeben wird, wird erkannt, wird jedoch vom Miniporttreiber nicht unterstützt.
NDIS_STATUS_BUFFER_TOO_SHORT	Der bei OidRequestbereitgestellte Puffer ist zu klein, um die angeforderten Daten zu speichern.
NDIS_STATUS_INVALID_LENGTH	Der im InformationBufferLength Member der NDIS_OID_REQUEST-Struktur bei OidRequest- angegebene Wert ist für den angegebenen OID_ XXX- Code falsch.
NDIS_STATUS_INVALID_DATA	Mindestens einer der Parameter, die für die Anforderung bei OidRequest- angegeben sind, ist ungültig.
NDIS_STATUS_NOT_ACCEPTED	Nach dem Aufrufen der MiniportDevicePNPEventNotify Funktion, um auf eine Überraschung hinzuweisen, ruft NDIS die MiniportHaltEx Funktion des Fahrers auf. Wenn der Treiber OID-Anforderungen empfängt, bevor NDIS MiniportHaltExaufruft, sollte er diese Anforderungen sofort mit dem Statuswert NDIS_STATUS_NOT_ACCEPTED abschließen.
NDIS_STATUS_REQUEST_ABORTED	Der Miniporttreiber hat die Verarbeitung der Anforderung beendet. Beispielsweise hat NDIS die funktion MiniportResetEx aufgerufen.
NDIS_STATUS_INDICATION_REQUIRED	Der Miniporttreiber stellt einen OID-Abschlussstatus mit einer nachfolgenden Statusanzeige bereit. Ein Miniporttreiber kann nicht NDIS_STATUS_INDICATION_REQUIRED zurückgeben, es sei denn, der bestimmte OID lässt ihn zu. Informationen dazu, ob dieser Status zulässig ist, finden Sie auf der OID-Referenzseite.To determine if this status is allowed, see the OID reference page.. Weitere Informationen zu NDIS_STATUS_INDICATION_REQUIRED finden Sie unter NDIS_OID_REQUEST und NDIS_STATUS_INDICATION.

Bemerkungen

Ein Treiber gibt den MiniportOidRequest Einstiegspunkt an, wenn er die NdisMRegisterMiniportDriver Funktion.

NDIS ruft die MiniportOidRequest--Funktion entweder im eigenen Auftrag oder im Namen eines gebundenen Protokolltreibers auf, der die NdisOidRequest Funktion aufgerufen hat. Miniport-Treiber sollten die anforderung untersuchen, die bei OidRequest- bereitgestellt wird, und die angeforderte Aktion ausführen. Weitere Informationen zu den OIDs, die Miniporttreiber behandeln, finden Sie unter NDIS OIDs.

Beachten Sie, dass NDIS den OID-spezifischen Inhalt bei OidRequest- nicht überprüft. Daher muss der Treiber selbst diese Inhalte überprüfen. Wenn der Treiber feststellt, dass der festzulegende Wert außerhalb der Grenzen liegt, sollte die Anforderung fehlschlagen und NDIS_STATUS_INVALID_DATA zurückgeben.

Wenn MiniportOidRequest- NDIS_STATUS_PENDING zurückgibt, ruft NDIS MiniportOidRequest- mit einer anderen Anforderung für den miniportAdapterContext auf, bis die ausstehende Anforderung abgeschlossen ist.

Hinweis Die NDIS-Check-for-Hang-Logik setzt keinen Miniporttreiber zurück, der nicht reagiert, wenn der Miniporttreiber im Kontext des MiniportOidRequest Aufrufs wartet. Daher sollten Miniporttreiber nicht warten, bis Hardwarevorgänge im Kontext des MiniportOidRequest Aufrufs abgeschlossen sind. Stattdessen kann der Treiber NDIS_STATUS_PENDING zurückgeben und eine Arbeitsaufgabe in die Warteschlange stellen.

NDIS ruft MiniportOidRequest bei IRQL auf == PASSIVE_LEVEL .

beispiele für

Um eine MiniportOidRequest--Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der Funktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Funktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine MiniportOidRequest--Funktion zu definieren, die den Namen "MyOidRequest" hat, verwenden Sie den MINIPORT_OID_REQUEST Typ, wie in diesem Codebeispiel gezeigt:

MINIPORT_OID_REQUEST MyOidRequest;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
NDIS_STATUS
 MyOidRequest(
    NDIS_HANDLE  MiniportAdapterContext,
    PNDIS_OID_REQUEST  OidRequest
    )
  {...}

Der MINIPORT_OID_REQUEST Funktionstyp wird in der Ndis.h-Headerdatei definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp MINIPORT_OID_REQUEST in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.

Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.

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
DDI-Complianceregeln	NdisOidComplete, NdisOidDoubleComplete, NdisOidDoubleRequest, NdisTimedOidComplete, WlanAssociation, WlanDisassociation, WlanTimedAssociation, WlanTimedConnectionRoaming, WlanTimedConnectRequest, WlanTimedLinkQuality, WlanTimedScan