Fungsi NdisFDirectOidRequest (ndis.h)

Artikel
02/26/2024

Driver filter memanggil fungsi NdisFDirectOidRequest untuk meneruskan permintaan OID langsung ke driver yang mendasar atau untuk memulai permintaan tersebut.

Sintaks

NDIS_STATUS NdisFDirectOidRequest(
  [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 tertentu . Struktur dapat menentukan permintaan kueri, set, atau metode OID.

Nilai kembali

Untuk daftar kemungkinan nilai yang dikembalikan, lihat fungsi NdisDirectOidRequest .

Keterangan

Fungsi NdisFDirectOidRequest tidak dapat digunakan untuk permintaan OID umum. Untuk permintaan OID umum, gunakan fungsi NdisFOidRequest sebagai gantinya. NdisFDirectOidRequest hanya dapat digunakan untuk OID yang didukung NDIS untuk digunakan dengan antarmuka OID langsung. Misalnya, OID berikut dapat digunakan:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA

Driver filter dapat memulai permintaan OID langsung ke driver yang mendasar dengan memanggil NdisFDirectOidRequest.

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

Jika NdisFDirectOidRequest mengembalikan NDIS_STATUS_PENDING, NDIS memanggil fungsi FilterDirectOidRequestComplete setelah driver yang mendasar menyelesaikan permintaan OID. Driver yang memanggil NdisFDirectOidRequest harus mendaftarkan fungsi FilterDirectOidRequestComplete .

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

Antarmuka permintaan OID langsung mirip dengan antarmuka permintaan OID umum. Untuk informasi selengkapnya tentang mengeluarkan permintaan umum, lihat NdisFOidRequest.

Persyaratan

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