RxFinalizeNetRoot-Funktion (fcb.h)

Artikel
02/06/2025

RxFinalizeNetRoot schließt die angegebene NET_ROOT Struktur ab. Der Aufrufer muss über eine exklusive Sperre in der Netname-Tabelle verfügen, die dem Geräteobjekt zugeordnet ist.

Syntax

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

Parameter

[out] ThisNetRoot

Ein Zeiger auf die NET_ROOT Struktur, die abgeschlossen werden soll.

[in] RecursiveFinalize

Der Wert, der angibt, ob die Fertigstellung rekursiv durchgeführt werden soll.

[in] ForceFinalize

Der Wert, der angibt, ob die Fertigstellung erzwungen werden soll, unabhängig von der Referenzanzahl.

Wenn ForceFinalize-FALSE-ist, muss das NodeReferenceCount-Element der NET_ROOT Struktur, auf das ThisNetRoot-verweist, 1 sein, damit die NET_ROOT abgeschlossen werden.

Rückgabewert

RxFinalizeNetRoot- gibt TRUE bei Erfolg zurück oder FALSE, wenn die Endisierung nicht auftritt: Wenn bereits eine Finalisierung des NET_ROOT ausgeführt wird, gibt RxFinalizeNetRoot-FALSEzurück.

Bemerkungen

Die RxFinalizeNetRoot Routine wird normalerweise nicht von Netzwerk-Miniumleitungstreibern direkt aufgerufen. RDBSS ruft diese Routine intern auf, wenn die Referenzanzahl für die NET_ROOT auf 1 erhöht wird.

Vor dem Aufrufen RxFinalizeNetRoot-muss eine Sperre der dem Geräteobjekt zugeordneten Netname-Tabelle im exklusiven Modus abgerufen werden.

Wenn der RecursiveFinalize Parameter TRUEist, löscht RxFinalizeNetRoot- alle verwaisten FCB-Strukturen, die diesem NET_ROOT zugeordnet sind. Diese verwaisten FCBs sind Strukturen, in denen das FcbState Mitglied die FCB_STATE_ORPHANED Flagge gesetzt hat.