Fungsi NdisFSynchronousOidRequest (ndis.h)

  • Artikel

Driver filter memanggil fungsi NdisFSynchronousOidRequest untuk memulai permintaan OID Sinkron baru dan mengeluarkannya ke driver yang mendasar.

Fungsi ini didukung di NDIS 6.81 dan yang lebih baru.

Sintaks

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

Parameter

[in] NdisFilterModuleHandle

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

Fungsi ini mengembalikan nilai yang sama dengan NdisDirectOidRequestkecuali bahwa NDIS_STATUS_PENDING tidak pernah dikembalikan dari fungsi ini.

Keterangan

Fungsi NdisFSynchronousOidRequest tidak dapat digunakan untuk permintaan OID umum. Untuk permintaan OID umum, gunakan fungsi NdisFOidRequest sebagai gantinya. NdisFSynchronousOidRequest hanya dapat digunakan untuk OID yang didukung NDIS untuk digunakan dengan antarmuka OID Sinkron. Sebagian besar driver filter tidak perlu memanggil NdisFSynchronousOidRequest.

Driver filter tidak boleh menyelesaikan FilterDetach sampai permintaan OID Sinkron yang berasal dari driver filter selesai.

Driver filter tidak diperlukan untuk mengimplementasikan FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequest, atau FilterSynchronousOidRequestComplete untuk memanggil NdisFSynchronousOidRequest. Seperti namanya, permintaan OID Sinkron selalu selesai secara sinkron, sehingga tidak ada panggilan balik asinkron.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10 versi 1709
Target Platform Universal
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL <= DISPATCH_LEVEL

Lihat juga

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

Antarmuka Permintaan OID Sinkron di NDIS 6.80