CcSetBcbOwnerPointer function (ntifs.h)

The CcSetBcbOwnerPointer routine sets the owner thread pointer for a pinned buffer control block (BCB).

Syntax

void CcSetBcbOwnerPointer(
  [in] PVOID Bcb,
  [in] PVOID OwnerPointer
);

Parameters

[in] Bcb

Pointer to a pinned BCB structure that is owned by the current thread.

[in] OwnerPointer

A valid resource owner pointer, which means a pointer to an allocated system address, with the low-order two bits set. This address may not be deallocated until after the BCB is unpinned by a subsequent call to CcUnpinDataForThread.

Return value

None

Remarks

File systems call CcSetBcbOwnerPointer to set the resource owner for a pinned buffer control block (BCB), in cases where another thread will unpin the BCB and thus the current thread can exit.

Each call to CcSetBcbOwnerPointer must be matched by a subsequent call to CcUnpinDataForThread, which must be called with the same owner pointer.

BCBs that have been modified by CcSetBcbOwnerPointer cannot be unpinned by calling CcUnpinData.

Requirements

Requirement Value
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe

See also

CcUnpinData

CcUnpinDataForThread

ExSetResourceOwnerPointer