Função RxFinalizeNetFobx (fcb.h)

Artigo
02/26/2024

RxFinalizeNetFOBX finaliza a estrutura DO FOBX fornecida. O chamador deve ter um bloqueio exclusivo no FCB associado à estrutura FOBX.

Sintaxe

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Parâmetros

[out] ThisFobx

Um ponteiro para a estrutura FOBX a ser finalizada.

[in] RecursiveFinalize

O valor que indica se a finalização deve ser feita recursivamente. Esse parâmetro não é usado no momento.

[in] ForceFinalize

O valor que indica se a finalização deve ser forçada, independentemente da contagem de referência.

Se ForceFinalize for FALSE, o membro NodeReferenceCount da estrutura FOBX apontada por ThisFobx deverá ser 0 para que o FOBX seja finalizado.

Retornar valor

RxFinalizeNetFOBX retornará TRUE em caso de êxito ou FALSE se a finalização não ocorrer:

Comentários

A rotina RxFinalizeNetFOBX normalmente não é chamada por drivers de minidiretório de rede diretamente. O RDBSS chama essa rotina internamente quando um pacote de solicitação de E/S é recebido para IRP_MJ_CLOSE. Normalmente, esse IRP é recebido pelo RDBSS em resposta a um aplicativo no modo de usuário solicitando uma operação de fechamento de arquivo. Também é possível que outro driver de kernel emita esse IRP.

Antes de chamar RxFinalizeNetFOBX, um bloqueio na estrutura FCB deve ser adquirido no modo exclusivo.

A rotina RxFinalizeNetFOBX chamará a rotina MRxDeallocateForFobx fornecida pelo minidiretório de rede para liberar a memória do FOBX se o minidiretório de rede der suporte a essa rotina.