fungsi FILTER_SYNCHRONOUS_OID_REQUEST_COMPLETE (ndis.h)

  • Artikel

NDIS memanggil fungsi FilterSynchronousOidRequestComplete driver filter setelah permintaan OID Sinkron selesai dari driver yang mendasar.

Fungsi ini didukung di NDIS 6.81 dan yang lebih baru.

Sintaks

void FILTER_SYNCHRONOUS_OID_REQUEST_COMPLETE(
  [in]      NDIS_HANDLE      FilterModuleContext,
  [in, out] NDIS_OID_REQUEST *OidRequest,
  [in, out] NDIS_STATUS      *Status,
  [in]      PVOID            CallContext
);

Parameter

[in] FilterModuleContext

Handel ke area konteks untuk modul filter yang merupakan target permintaan ini. Driver filter membuat dan menginisialisasi area konteks ini dalam fungsi FilterAttach .

[in, out] OidRequest

Penunjuk ke struktur NDIS_OID_REQUEST yang menentukan operasi yang sedang diselesaikan.

[in, out] Status

Penunjuk ke kode status yang dihasilkan dari permintaan yang sedang diselesaikan.

[in] CallContext

Slot penyimpanan berukuran PVOID untuk driver filter untuk berbagi status antara handler FilterSynchronousOidRequest dan FilterSynchronousOidRequestComplete . Jika driver filter mengimplementasikan handler FilterSynchronousOidRequest , parameter ini berisi nilai konteks yang dikembalikan oleh handler FilterSynchronousOidRequest . Jika tidak, jika driver filter tidak mengimplementasikan handler FilterSynchronousOidRequest , nilai ini adalah nol.

Nilai kembali

Tidak ada

Keterangan

FilterSynchronousOidRequestComplete adalah fungsi opsional. Jika driver filter tidak perlu mengamati atau memodifikasi permintaan OID Sinkron yang diselesaikan dari driver miniport, driver filter harus mengatur titik masuk untuk fungsi ini ke NULL saat memanggil NdisFRegisterFilterDriver.

NDIS memanggil fungsi FilterSynchronousOidRequestComplete driver filter untuk memproses permintaan OID Sinkron yang diselesaikan oleh driver yang mendasar. Driver filter dapat membaca atau mengubah beberapa bidang dalam struktur NDIS_OID_REQUEST sebagai berikut:

Bidang Memfilter akses
Header Baca-saja
RequestType Baca/Tulis
PortNumber Baca/Tulis
Batas waktu Jangan akses
RequestId Jangan akses
RequestHandle Baca/Tulis
DATA Baca/Tulis
NdisReserved Jangan akses
MiniportReserved Jangan akses
SourceReserved Jangan akses
SupportedRevision Baca/Tulis
Reserved1, Reserved2 Jangan akses
SwitchId Baca/Tulis
VPortId Baca/Tulis
Bendera Baca/Tulis

Selain memodifikasi struktur NDIS_OID_REQUEST , driver filter dapat membaca atau mengubah kode status tempat operasi selesai. Driver filter dapat menulis nilai baru ke parameter *Status . Driver filter tidak boleh menulis NDIS_STATUS_PENDING atau NDIS_STATUS_ALREADY_COMPLETE ke parameter *Status .

Jika driver filter juga mendaftarkan handler FilterSynchronousOidRequest , NDIS menjamin bahwa handler FilterSynchronousOidRequestComplete akan dipanggil jika dan hanya jika handler FilterSynchronousOidRequest mengembalikan NDIS_STATUS_SUCCESS.

Driver filter diharapkan kembali dari handler FilterSynchronousOidRequestComplete mereka dengan cepat, tanpa memblokir, menunggu, atau tidur. Permintaan OID sinkron hanya digunakan untuk operasi latensi rendah, dan driver filter harus berusaha untuk melanjutkan atau menyelesaikannya dalam beberapa milidetik.

NDIS tidak menserialisasikan permintaan OID Sinkron satu sama lain, terhadap permintaan OID lainnya, atau terhadap FilterPause. Merupakan tanggung jawab driver filter untuk menerapkan sinkronisasi yang diperlukan.

NDIS melakukan serialisasi permintaan OID Sinkron terhadap FilterDetach: NDIS menjamin bahwa tidak ada permintaan OID sinkron yang akan aktif setelah FilterDetach dipanggil.

Driver filter tidak boleh memanggil NdisAllocateCloneOidRequest atau NdisCancelOidRequest pada permintaan OID Sinkron. Driver filter tidak boleh memanggil NdisFSynchronousOidRequest pada permintaan OID yang diterima melalui handler FilterSynchronousOidRequestComplete .

Persyaratan

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

Lihat juga

FilterSynchronousOidRequest

NdisFSynchronousOidRequest

Antarmuka Permintaan OID Sinkron di NDIS 6.80