POOL_CREATE_EXTENDED_PARAMETER structure (wdm.h)

The POOL_CREATE_EXTENDED_PARAMETER structure is used within the Parameters array of POOL_CREATE_EXTENDED_PARAMS when calling ExCreatePool.

Syntax

typedef struct _POOL_CREATE_EXTENDED_PARAMETER {
  POOL_CREATE_EXTENDED_PARAMETER_TYPE Type;
  union {
    UNICODE_STRING PoolName;
  } DUMMYUNIONNAME;
} POOL_CREATE_EXTENDED_PARAMETER, *PPOOL_CREATE_EXTENDED_PARAMETER;

Members

Type

Specifies the parameter type. Must be a value from POOL_CREATE_EXTENDED_PARAMETER_TYPE.

DUMMYUNIONNAME

Anonymous union that contains the data for the parameter. Interpret the active member based on Type.

DUMMYUNIONNAME.PoolName

Valid only when Type == PoolCreateExtendedParameterName. A UNICODE_STRING specifying the name of the pool being created. Required (and must be non-empty) for paged and nonpaged private pools; must be omitted for secure pools. The string buffer must remain valid for the duration of the ExCreatePool call. The name is not case-sensitive for uniqueness checks.

Remarks

Only one parameter with Type == PoolCreateExtendedParameterName may be supplied in a single Parameters array.

Paged and nonpaged private pools must include exactly one name parameter.

Secure pools must not include a name parameter.

The structure does not own the underlying string buffer; the caller is responsible for allocation and freeing after the call returns.

Requirements

See also

ExCreatePool

POOL_CREATE_EXTENDED_PARAMS

POOL_CREATE_EXTENDED_PARAMETER_TYPE