Fungsi RxFinalizeNetRoot (fcb.h)

Artikel
02/26/2024

RxFinalizeNetRoot menyelesaikan struktur NET_ROOT yang diberikan. Pemanggil harus memiliki kunci eksklusif pada tabel netname yang terkait dengan objek perangkat.

Sintaks

BOOLEAN RxFinalizeNetRoot(
  [out] OUT PNET_ROOT ThisNetRoot,
  [in]  IN BOOLEAN    RecursiveFinalize,
  [in]  IN BOOLEAN    ForceFinalize
);

Parameter

[out] ThisNetRoot

Penunjuk ke struktur NET_ROOT untuk diselesaikan.

[in] RecursiveFinalize

Nilai yang menunjukkan apakah finalisasi harus dilakukan secara rekursif.

[in] ForceFinalize

Nilai yang menunjukkan apakah finalisasi harus dipaksakan, terlepas dari jumlah referensi.

Jika ForceFinalizefalse, maka anggota NodeReferenceCount dari strkuture NET_ROOT yang ditunjukkan oleh ThisNetRoot harus 1 agar NET_ROOT diselesaikan.

Nilai kembali

RxFinalizeNetRoot mengembalikan TRUE pada keberhasilan atau FALSE jika finalisasi tidak terjadi: Jika finalisasi NET_ROOT sudah dalam proses, RxFinalizeNetRoot akan mengembalikan FALSE.

Keterangan

Rutinitas RxFinalizeNetRoot biasanya tidak dipanggil oleh driver pengalih mini jaringan secara langsung. RDBSS memanggil rutinitas ini secara internal ketika jumlah referensi pada NET_ROOT dikurangi menjadi 1.

Sebelum memanggil RxFinalizeNetRoot, kunci pada tabel netname yang terkait dengan objek perangkat harus diperoleh dalam mode eksklusif.

Jika parameter RecursiveFinalizeTRUE, RxFinalizeNetRoot akan menghapus menyeluruh struktur FCB tanpa induk yang terkait dengan NET_ROOT ini. FBS ophaned ini adalah struktur di mana anggota FcbState memiliki bendera FCB_STATE_ORPHANED diatur.