NdisFOidRequest-Funktion (ndis.h)
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) |