Fungsi NdisFOidRequest (ndis.h)

  • Artikel

Driver filter memanggil fungsi NdisFOidRequest untuk meneruskan permintaan OID ke driver yang mendasar atau untuk berasal dari permintaan tersebut.

Sintaks

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

Parameter

[in] NdisFilterHandle

Handel NDIS yang mengidentifikasi modul filter. NDIS meneruskan handel ke driver filter dalam panggilan ke fungsi FilterAttach .

[in] OidRequest

Penunjuk ke struktur NDIS_OID_REQUEST yang menentukan operasi yang diminta dengan kode OID_XXX yang diberikan. Struktur dapat menentukan permintaan kueri, set, atau metode. Untuk informasi selengkapnya tentang OID, lihat OID NDIS.

Nilai kembali

Lihat fungsi NdisOidRequest .

Keterangan

Driver filter dapat berasal dari permintaan OID ke driver yang mendasar dengan memanggil NdisFOidRequest.

Driver filter juga dapat memfilter permintaan OID yang berasal dari driver yang terlalu berlebihan. NDIS memanggil fungsi FilterOidRequest untuk memproses setiap permintaan tersebut.

Jika NdisFOidRequest mengembalikan NDIS_STATUS_PENDING, NDIS memanggil fungsi FilterOidRequestComplete setelah driver yang mendasar menyelesaikan permintaan OID.

Jika NdisFOidRequest mengembalikan NDIS_STATUS_SUCCESS, NdisFOidRequest mengembalikan hasil permintaan kueri dalam struktur NDIS_OID_REQUEST di parameter OidRequest.

NdisFOidRequest dapat mengembalikan NDIS_STATUS_INVALID_PARAMETER jika driver filter melewati nilai yang tidak valid untuk bidang Tipe dan Ukuran di bidang Header dari struktur NDIS_OID_REQUEST .

Driver dapat memanggil NdisFOidRequest saat berada dalam status Memulai Ulang, Menjalankan, Menjeda, atau Dijeda .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI Irql_OID_Function(ndis)

Lihat juga

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest