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 não zero, em bytes, do buffer que a estrutura alocará para cada objeto de memória.

[in] PoolType

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

[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, em 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 KMDF 1.5 e posteriores, 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.

Valor retornado

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 gerente de E/S descarregue seu 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, as alças do objeto do dispositivo deverão ser as mesmas.

Para obter mais informações sobre objetos de memória da 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

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfmemory.h (include Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca de Estruturas).)
IRQL Consulte a seção Observações.
Regras de conformidade DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_OBJECT_ATTRIBUTES

WdfDriverCreate

WdfMemoryCreateFromLookaside