PFNBTH_ALLOCATE_BRB callback function (bthddi.h)

Article
02/22/2024

The BthAllocateBrb function allocates a Bluetooth request block (BRB) of the specified type.

Syntax

PFNBTH_ALLOCATE_BRB PfnbthAllocateBrb;

PBRB PfnbthAllocateBrb(
  [in] BRB_TYPE brbType,
  [in] ULONG tag
)
{...}

Parameters

[in] brbType

Specifies a value from the BRB_TYPE enumeration to initialize the BRB with.

[in] tag

Specifies a 4-byte pool tag that uniquely identifies the driver that does the memory allocation. For more information about pool tags, see ExAllocatePoolWithTag.

Return value

BthAllocateBrb returns a pointer to the newly allocated BRB, or NULL if the system is out of memory.

Remarks

Profile drivers obtain a pointer to the BthAllocateBrb function when they query the Bluetooth driver stack for an instance of the BTHDDI_PROFILE_DRIVER_INTERFACE driver interface. See Querying for Bluetooth Interfaces for more information about querying the Bluetooth driver stack.

Requirements

Requirement	Value
Minimum supported client	Versions:_Supported in Windows Vista, and later.
Target Platform	Desktop
Header	bthddi.h (include Bthddi.h)
IRQL	<= DISPATCH_LEVEL