LLC_BUFFER_CREATE_PARMS

The LLC_BUFFER_CREATE_PARMS structure is the DLC parameter table for the LLC_BUFFER_CREATE command. You pass a pointer to this structure using the pParameterTable member of the CCB_PARMS union.

typedef struct {
    HANDLE hBufferPool; 
    PVOID pBuffer; 
    ULONG cbBufferSize; 
    ULONG cbMinimumSizeThreshold; 
} LLC_BUFFER_CREATE_PARMS, *PLLC_BUFFER_CREATE_PARMS;
 

Members

hBufferPool

Handle to the created buffer pool.

pBuffer

Specifies the address of an application-supplied buffer. The buffer can be statically allocated or dynamically allocated from the heap. The minimum size requirement is 0x2000. The buffer manager allocates all DLC buffers from this virtual buffer. This buffer area must not be used for anything else.

cbBufferSize

The total size of the buffer, pBuffer, in bytes.

cbMinimumSizeThreshold

The minimum locked size. The buffer manager tries to keep at least this much free space in the buffer pool. This parameter should be large enough to hold all data received between two sequential LLC_READ commands.

Remarks

Win32 DLC supports one buffer pool per process. After you open an adapter using the LLC_DIR_OPEN_ADAPTER command, you must give the DLC driver a buffer pool by using the LLC_BUFFER_CREATE command.

You should carefully select the total and minimum buffer pool sizes, because the memory manager has a dynamic quota of available pages for each process. Your application may not run if it tries to allocate a buffer pool that is too large.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in dlcapi.h.

See Also

The DLC Interface Overview, DLC Structures, AcsLan, CCB_PARMS