estrutura POOL_CREATE_EXTENDED_PARAMS (wdm.h)

Define a estrutura POOL_CREATE_EXTENDED_PARAMS.

Sintaxe

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

Membros

Version

ULONG que especifica a versão dessa estrutura. Definido como POOL_CREATE_PARAMS_VERSION (atualmente 1). Qualquer outro valor faz com que o ExCreatePool falhe com STATUS_INVALID_PARAMETER. Versões futuras podem estender essa estrutura; os drivers devem sempre inicializar esse campo explicitamente.

ParameterCount

Número de elementos na matriz apontada por Parâmetros. Deve ser 0 se nenhum parâmetro estendido for fornecido.

Parameters

Ponteiro para uma matriz de entradas de POOL_CREATE_EXTENDED_PARAMETER que fornecem parâmetros de criação adicionais. Deve ser NULL quando ParameterCount for 0. O campo Tipo de cada entrada identifica o tipo de parâmetro. Atualmente, o único tipo válido é PoolCreateExtendedParameterName, que fornece o nome Unicode do pool no membro PoolName . O nome deve ser exclusivo dentro do contexto de criação do driver e seguir quaisquer restrições de nomenclatura internas. Tipos de parâmetro sem suporte ou duplicados são rejeitados.

Observações

Use essa estrutura para passar dados de criação estendidos opcionais (ou necessários) para o ExCreatePool por meio de seu argumento Params .

Pools privados paginados e nãopagados devem especificar exatamente um parâmetro de nome. Pools seguros não devem especificar um parâmetro de nome.

Se ParameterCount não for zero, os parâmetros deverão apontar para uma matriz válida e legível de várias entradas.

Tipos de parâmetro não reconhecidos pelo kernel ou que aparecem mais de uma vez fazem com que o ExCreatePool retorne STATUS_INVALID_PARAMETER_3.

A estrutura é versão para permitir a compatibilidade de encaminhamento; os drivers não devem assumir que campos adicionais permanecem zero em versões futuras— sempre verifique a versão antes de interpretar extensões não reconhecidas (se a leitura de um buffer tiver se originado em outro lugar).

Requisitos

Consulte também

ExCreatePool

ExDestroyPool