POOL_CREATE_EXTENDED_PARAMS Struktur (wdm.h)

Definiert die POOL_CREATE_EXTENDED_PARAMS-Struktur.

Syntax

typedef struct _POOL_CREATE_EXTENDED_PARAMS {
  ULONG                           Version;
  ULONG                           ParameterCount;
  PPOOL_CREATE_EXTENDED_PARAMETER Parameters;
} POOL_CREATE_EXTENDED_PARAMS, *PPOOL_CREATE_EXTENDED_PARAMS;

Angehörige

Version

ULONG, das die Version dieser Struktur angibt. Auf POOL_CREATE_PARAMS_VERSION (derzeit 1) festgelegt. Jeder andere Wert führt dazu, dass ExCreatePool mit STATUS_INVALID_PARAMETER fehlschlägt. Zukünftige Versionen können diese Struktur erweitern; Treiber müssen dieses Feld immer explizit initialisieren.

ParameterCount

Die Anzahl der Elemente im Array, auf die durch Parameter verwiesen wird. Muss 0 sein, wenn keine erweiterten Parameter angegeben werden.

Parameters

Zeigen Sie auf ein Array von POOL_CREATE_EXTENDED_PARAMETER Einträgen, die zusätzliche Erstellungsparameter bereitstellen. Muss NULL sein, wenn ParameterCount 0 ist. Das Feld "Type " jedes Eintrags identifiziert die Parameterart. Derzeit ist der einzige gültige Typ PoolCreateExtendedParameterName, der den Unicode-Namen des Pools im PoolName-Element bereitstellt. Der Name muss innerhalb des Erstellungstreiberkontexts eindeutig sein und allen internen Benennungseinschränkungen folgen. Nicht unterstützte oder doppelte Parametertypen werden abgelehnt.

Bemerkungen

Verwenden Sie diese Struktur, um optionale (oder erforderliche) erweiterte Erstellungsdaten über das Params-Argument an ExCreatePool zu übergeben.

Ausgelagerte und nicht ausgelagerte private Pools müssen genau einen Namensparameter angeben. Sichere Pools dürfen keinen Namensparameter angeben.

Wenn ParameterCount ungleich Null ist, müssen Parameter auf ein gültiges, lesbares Array dieser vielen Einträge verweisen.

Parametertypen, die vom Kernel nicht erkannt werden oder mehr als einmal angezeigt werden, führen dazu, dass ExCreatePoolSTATUS_INVALID_PARAMETER_3 zurückgibt.

Die Struktur ist versioniert, um die Weiterleitungskompatibilität zu ermöglichen; Treiber sollten nicht davon ausgehen, dass zusätzliche Felder in zukünftigen Versionen null bleiben – überprüfen Sie immer die Version, bevor Sie nicht erkannte Erweiterungen interpretieren (wenn ein Puffer an anderer Stelle gelesen wurde).

Anforderungen

Siehe auch

ExCreatePool

ExDestroyPool