структура POOL_CREATE_EXTENDED_PARAMS (wdm.h)

Определяет структуру POOL_CREATE_EXTENDED_PARAMS.

Синтаксис

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

Члены

Version

ULONG, указывающий версию этой структуры. Установите значение POOL_CREATE_PARAMS_VERSION (в настоящее время — 1). Любое другое значение приводит к сбою ExCreatePool с STATUS_INVALID_PARAMETER. Будущие версии могут расширить эту структуру; Драйверы должны всегда инициализировать это поле явным образом.

ParameterCount

Число элементов в массиве, на которое указывает параметры. Значение должно быть 0, если не предоставляются расширенные параметры.

Parameters

Указатель на массив записей POOL_CREATE_EXTENDED_PARAMETER , которые предоставляют дополнительные параметры создания. Значение NULL должно иметь значение NULL, если ПараметрCount равен 0. Поле типа каждой записи определяет тип параметра. В настоящее время единственным допустимым типом является PoolCreateExtendedParameterName, который предоставляет имя Юникода пула в члене PoolName . Имя должно быть уникальным в контексте создания драйвера и следовать любым внутренним ограничениям именования. Неподдерживаемые или повторяющиеся типы параметров отклоняются.

Замечания

Используйте эту структуру для передачи необязательных (или обязательных) данных создания в ExCreatePool через его аргумент Params .

Страницы и непагированные частные пулы должны указывать ровно один параметр имени. Безопасные пулы не должны указывать параметр имени.

Если ПараметрCount не равен нулю, параметры должны указывать на допустимый, доступный для чтения массив этих записей.

Типы параметров, не распознанные ядром или появляющиеся несколько раз, вызывают возврат STATUS_INVALID_PARAMETER_3 ExCreatePool.

Структура имеет версию для обеспечения совместимости вперед; Драйверы не должны предполагать, что дополнительные поля остаются нулевыми в будущих выпусках, всегда проверяйте версию перед интерпретацией нераспознанных расширений (если чтение буфера возникло в другом месте).

Требования

См. также

ExCreatePool

ExDeskPool