DosSubSetMem - Parameters

pbBase (PVOID) - input

The address of the memory pool to be used for suballocation.

flag (ULONG) - input

Indicators describing the characteristics of the memory object that is being suballocated.

This parameter consists of the following bit fields:

Bit

Description
0
DOSSUB_INIT (0x00000001) This bit must be set to initialize a memory object for suballocation. Otherwise, the request is to attach a process to a shared memory pool that was previously initialized by another process using DosSubSetMem.
1
DOSSUB_GROW (0x00000002)
If this bit is set, then the request is to increase the size of the memory pool being managed. Bit 0 then has no meaning.
2
DOSSUB_SPARSE_OBJ (0x00000004)
Bit 2 is set if the requester wants a suballocation function to manage the commitment of the pages spanned by the memory pool.

All of the pages spanned by the object must be initially uncommitted. If this bit is clear, the suballocation function assumes that all of the pages spanned by the memory pool are valid and committed.

For a DosSubSetMem(Grow) request, the setting of this bit should be the same as when the memory pool was initialized. Otherwise, an error is returned.

3
DOSSUB_SERIALIZE (0x00000008)
This bit is set if the requester requires access to the memory pool to be serialized.

For shared memory pools, the first DosSubSetMem(Init or Serialize) request causes the memory pool to be created and opened for the requesting process.

Subsequent DosSubSetMem(Attach or Serialize) requests cause the shared memory pool to be attached to the requesting process. The requesting process must first gain access to the memory object that the pool resides in. DosSubSetMem(Attach) is indicated when bit 0 is off.

On a DosSubSetMem(Grow) request, bit 3 should be the same as when the memory pool was initialized, or an error is returned.

cb (ULONG) - input

The size, in bytes, of the memory pool.

If the size is not a multiple of 8 bytes, it is rounded down to a multiple of 8.

ulrc (APIRET) - returns

Return Code.

DosSubSetMem returns one of the following values:

• NO_ERROR 87
  ERROR_INVALID_PARAMETER
  310
  ERROR_DOSSUB_SHRINK
  For a full list of error codes, see Errors.

---

[Back: DosSubSetMem Return Value - ulrc]
[Next: DosSubSetMem - Remarks]