Skip to content

Latest commit

 

History

History
68 lines (52 loc) · 2.03 KB

nf-portcls-idmachannel-allocatebuffer.md

File metadata and controls

68 lines (52 loc) · 2.03 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library targetos f1_keywords topic_type api_type api_location api_name
NF:portcls.IDmaChannel.AllocateBuffer
IDmaChannel::AllocateBuffer (portcls.h)
The AllocateBuffer method allocates a common buffer that can be accessed by the port driver and DMA hardware.
audio
10/31/2018
IDmaChannel::AllocateBuffer
IDmaChannel::AllocateBuffer, AllocateBuffer, IDmaChannel.AllocateBuffer, IDmaChannel::AllocateBuffer, IDmaChannel.AllocateBuffer
portcls.h
PASSIVE_LEVEL
Windows
IDmaChannel::AllocateBuffer
portcls/IDmaChannel::AllocateBuffer
apiref
COM
portcls.h
IDmaChannel::AllocateBuffer

IDmaChannel::AllocateBuffer

-description

The AllocateBuffer method allocates a common buffer that can be accessed by the port driver and DMA hardware.

-parameters

-param BufferSize

Specifies the size in bytes of the buffer to be allocated.

-param PhysicalAddressConstraint

Specifies an optional constraint to place on the physical address of the buffer. If this parameter is non-NULL, only the bits that are set in the constraint address will vary from the beginning to the end of the buffer. For example, to request a buffer that does not cross a 64-kilobyte boundary, specify the physical address constraint 0x000000000000FFFF.

-returns

This method returns NTSTATUS. AllocateBuffer returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

-remarks

This method must be called only once following the creation of the DMA-channel object unless the previously allocated buffer is first freed by calling FreeBuffer.

-see-also

IDmaChannel