POOL_CREATE_EXTENDED_PARAMETER Struktur (wdm.h)

Die POOL_CREATE_EXTENDED_PARAMETER Struktur wird innerhalb des Parameters-Arrays von POOL_CREATE_EXTENDED_PARAMS beim Aufrufen von ExCreatePool verwendet.

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;

Elemente

Type

Gibt den Parametertyp an. Muss ein Wert aus POOL_CREATE_EXTENDED_PARAMETER_TYPE sein.

DUMMYUNIONNAME

Anonyme Vereinigung, die die Daten für den Parameter enthält. Interpretieren des aktiven Elements basierend auf "Type".

DUMMYUNIONNAME.PoolName

Nur gültig, wenn Type == PoolCreateExtendedParameterName. Ein UNICODE_STRING, der den Namen des zu erstellenden Pools angibt. Erforderlich (und muss nicht leer sein) für ausgelagerte und nicht ausgelagerte private Pools; muss für sichere Pools weggelassen werden. Der Zeichenfolgenpuffer muss für die Dauer des ExCreatePool-Aufrufs gültig bleiben. Bei Eindeutigkeitsprüfungen wird die Groß-/Kleinschreibung nicht beachtet.

Bemerkungen

Es kann nur ein Parameter mit Type == PoolCreateExtendedParameterName in einem einzigen Parameterarray angegeben werden.

Ausgelagerte und nicht ausgelagerte private Pools müssen genau einen Namensparameter enthalten.

Sichere Pools dürfen keinen Namensparameter enthalten.

Die Struktur besitzt nicht den zugrunde liegenden Zeichenfolgenpuffer; der Anrufer ist für die Zuordnung und das Freigeben nach der Rückgabe des Anrufs verantwortlich.

Anforderungen

Siehe auch

ExCreatePool

POOL_CREATE_EXTENDED_PARAMS

POOL_CREATE_EXTENDED_PARAMETER_TYPE