Função WdfLookasideListCreate (wdfmemory.h)

[Aplica-se somente ao KMDF]

O método WdfLookasideListCreate cria um objeto lookaside-list, do qual o driver pode obter objetos de memória.

Sintaxe

NTSTATUS WdfLookasideListCreate(
  [in, optional] PWDF_OBJECT_ATTRIBUTES LookasideAttributes,
  [in]           size_t                 BufferSize,
  [in]           POOL_TYPE              PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES MemoryAttributes,
  [in, optional] ULONG                  PoolTag,
  [out]          WDFLOOKASIDE           *Lookaside
);

Parâmetros

[in, optional] LookasideAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos de objeto para o novo objeto lookaside-list. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[in] BufferSize

O tamanho diferente de zero, em bytes, do buffer que a estrutura alocará para cada objeto de memória.

[in] PoolType

Um valor de tipo POOL_TYPE que especifica o tipo de memória a ser alocado.

[in, optional] MemoryAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos de objeto para cada objeto de memória que o driver obtém da lista lookaside. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[in, optional] PoolTag

Uma marca de pool definida pelo driver para o buffer de cada objeto de memória. Os depuradores exibem essa marca. Os drivers normalmente especificam uma cadeia de caracteres de até quatro caracteres, delimitada por aspas simples, na ordem inversa (por exemplo, 'dcba'). O valor ASCII de cada caractere na marca deve estar entre 0 e 127. A depuração do driver será mais fácil se cada marca de pool for exclusiva.

Se PoolTag for zero, a estrutura fornecerá uma marca de pool padrão que usa os quatro primeiros caracteres do nome do serviço do modo kernel do driver. Se o nome do serviço começar com "WDF" (o nome não diferencia maiúsculas de minúsculas e não inclui as aspas), os próximos quatro caracteres serão usados. Se menos de quatro caracteres estiverem disponíveis, "FxDr" será usado.

Para as versões 1.5 e posteriores do KMDF, o driver pode usar o membro DriverPoolTag da estrutura WDF_DRIVER_CONFIG para especificar uma marca de pool padrão.

[out] Lookaside

Um ponteiro para um local que recebe um identificador para o novo objeto lookaside-list.

Retornar valor

WdfLookasideListCreate retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi detectado.
STATUS_INSUFFICIENT_RESOURCES	Não havia memória suficiente.

 

Para obter uma lista de outros valores retornados que o método WdfLookasideListCreate pode retornar, consulte Erros de criação de objeto da estrutura.

Esse método também pode retornar outros valores NTSTATUS.

Comentários

Depois que o driver chama WdfLookasideListCreate para criar um objeto lookaside-list, o driver pode chamar WdfMemoryCreateFromLookaside para obter um buffer da lista lookaside.

Por padrão, o pai do novo objeto lookaside-list é o objeto de driver de estrutura que o método WdfDriverCreate cria. Você pode usar o membro ParentObject da estrutura WDF_OBJECT_ATTRIBUTES para especificar um pai diferente. A estrutura exclui o objeto lookaside-list quando exclui o objeto pai. Se o driver não alterar o pai padrão, o driver deverá excluir o objeto lookaside-list quando terminar de usar o objeto ; caso contrário, o objeto lookaside-list permanecerá até que o gerenciador de E/S descarregue o driver.

Se o driver fornecer uma estrutura WDF_OBJECT_ATTRIBUTES para os parâmetros LookasideAttributes e MemoryAttributes e se ambas as estruturas especificarem um objeto de dispositivo como o objeto pai, os identificadores de objeto do dispositivo deverão ser os mesmos.

Para obter mais informações sobre objetos de memória de estrutura e listas lookaside, consulte Usando buffers de memória.

Se o driver especificar PagedPool para o parâmetro PoolType , o método WdfLookasideListCreate deverá ser chamado em IRQL <= APC_LEVEL. Caso contrário, o método pode ser chamado em IRQL <= DISPATCH_LEVEL.

Exemplos

Para obter um exemplo de código que usa WdfLookasideListCreate, consulte WdfMemoryCreateFromLookaside.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfmemory.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	Consulte a seção Observações.
Regras de conformidade da DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_OBJECT_ATTRIBUTES

WdfDriverCreate

WdfMemoryCreateFromLookaside