NdisFDirectOidRequest-Funktion (ndis.h)

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

Syntax

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

Parameter

[in] NdisFilterHandle

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

[in] OidRequest

Ein Zeiger auf eine NDIS_OID_REQUEST Struktur, die den Vorgang angibt, der mit einem bestimmten OID_Xxx--Code angefordert wird. Die Struktur kann eine OID-Abfrage, einen Satz oder eine Methodenanforderung angeben.

Rückgabewert

Eine Liste der möglichen Rückgabewerte finden Sie in der funktion NdisDirectOidRequest.

Bemerkungen

Die NdisFDirectOidRequest Funktion kann nicht für allgemeine OID-Anforderungen verwendet werden. Verwenden Sie für allgemeine OID-Anforderungen stattdessen die NdisFOidRequest Funktion. NdisFDirectOidRequest- kann nur für OIDs verwendet werden, die NDIS für die Verwendung mit der direkten OID-Schnittstelle unterstützt. Beispielsweise können die folgenden OIDs verwendet werden:

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

Filtertreiber können auch direkte OID-Anforderungen filtern, die von übermäßigen Treibern stammen. NDIS ruft die FilterDirectOidRequest--Funktion auf, um jede solche Anforderung zu verarbeiten.

Wenn NdisFDirectOidRequestNDIS_STATUS_PENDINGzurückgibt, ruft NDIS die FilterDirectOidRequestComplete-funktion auf, nachdem die zugrunde liegenden Treiber die OID-Anforderung abgeschlossen haben. Ein Treiber, der NdisFDirectOidRequest- aufruft, muss die funktion FilterDirectOidRequestComplete registrieren.

Ein Treiber kann NdisFDirectOidRequest- aufrufen, wenn er sich im zustand "Restarting, Running, Pausingoder Angehalten Zustand befindet.

Die direkte OID-Anforderungsschnittstelle ähnelt der allgemeinen OID-Anforderungsschnittstelle. Weitere Informationen zum Ausgeben allgemeiner Anforderungen finden Sie unter NdisFOidRequest.

Anforderungen

Siehe auch

FilterAttach-

FilterDirectOidRequest-

NDIS_OID_REQUEST

NdisDirectOidRequest

NdisFOidRequest