Fungsi RxAcquireSharedFcbResourceInMRx (mrxfcb.h)

Artikel
02/26/2024

RxAcquireSharedFcbResourceInMRx memperoleh sumber daya FCB untuk driver pengalih mini jaringan dalam mode bersama. Rutinitas ini akan menunggu sumber daya FCB gratis jika sebelumnya diperoleh secara eksklusif dan tidak mengembalikan kontrol sampai sumber daya bersama diperoleh.

Sintaks

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

Parameter

Fcb

Penunjuk ke FCB. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

RxAcquireSharedFcbResourceInMRx mengembalikan STATUS_SUCCESS pada keberhasilan atau salah satu kode kesalahan berikut pada kegagalan:

Menampilkan kode	Deskripsi
STATUS_LOCK_NOT_GRANTED	Sumber daya FCB tidak diperoleh.
STATUS_CANCELLED	RX_CONTEXT yang terkait dengan FCB dibatalkan.

Keterangan

Sumber daya sinkronisasi yang menarik bagi driver pengalih mini jaringan terutama dikaitkan dengan FCB. Ada sumber daya I/O halaman dan sumber daya reguler. Sumber daya I/O halaman dikelola secara internal oleh RDBSS. Satu-satunya sumber daya yang dapat diakses oleh driver mini-redirector jaringan adalah sumber daya reguler yang harus diakses menggunakan RxAcquireExclusiveFcbResourceInMRx, RxAcquireExclusiveFcbResourceInMRxEx, atau RxAcquireSharedFcbResourceInMRx, tergantung pada mode yang diperoleh yang diinginkan.

RxAcquireSharedFcbResourceInMRx akan menunggu sumber daya FCB gratis jika sebelumnya diperoleh secara eksklusif dan tidak mengembalikan kontrol sampai sumber daya bersama diperoleh. Rutinitas ini memperoleh sumber daya FCB meskipun RX_CONTEXT yang terkait dengan FCB ini telah dibatalkan.

Sumber daya FCB yang diperoleh dengan RxAcquireSharedFcbResourceInMRx harus dirilis dengan memanggil RxReleaseFcbResourceInMRx atau RxReleaseFcbResourceForThreadInMRx.