NdisFOidRequest-Funktion (ndis.h)

Artikel
03/05/2024

Filtertreiber rufen die NdisFOidRequest-Funktion auf, um eine OID-Anforderung an zugrunde liegende Treiber weiterzuleiten oder eine solche Anforderung zu erstellen.

Syntax

NDIS_STATUS NdisFOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Parameter

[in] NdisFilterHandle

Ein NDIS-Handle, das ein Filtermodul identifiziert. NDIS hat den Handle in einem Aufruf der FilterAttach-Funktion an den Filtertreiber übergeben.

[in] OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST-Struktur , die den mit einem angegebenen OID_XXX-Code angeforderten Vorgang angibt. Die Struktur kann eine Abfrage, einen Satz oder eine Methodenanforderung angeben. Weitere Informationen zu OIDs finden Sie unter NDIS-OIDs.

Rückgabewert

Siehe die NdisOidRequest-Funktion .

Hinweise

Filtertreiber können OID-Anforderungen an zugrunde liegende Treiber erstellen, indem sie NdisFOidRequest aufrufen.

Filtertreiber können auch OID-Anforderungen filtern, die von überlasteten Treibern stammen. NDIS ruft die FilterOidRequest-Funktion auf, um jede solche Anforderung zu verarbeiten.

Wenn NdisFOidRequestNDIS_STATUS_PENDING zurückgibt, ruft NDIS die FilterOidRequestComplete-Funktion auf, nachdem die zugrunde liegenden Treiber die OID-Anforderung abgeschlossen haben.

Wenn NdisFOidRequestNDIS_STATUS_SUCCESS zurückgibt, werden die Ergebnisse einer Abfrageanforderung in der NDIS_OID_REQUEST-Struktur am OidRequest-Parameter zurückgegeben.

NdisFOidRequest kann NDIS_STATUS_INVALID_PARAMETER zurückgeben, wenn der Filtertreiber ungültige Werte für die Felder Typ und Größe im Feld Header der NDIS_OID_REQUEST-Struktur übergibt.

Ein Treiber kann NdisFOidRequest aufrufen, wenn er sich im Status Neustarten, Ausführen, Anhalten oder Anhalten befindet .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_OID_Function(ndis)