Função KsAllocateObjectCreateItem (ks.h)

A função KsAllocateObjectCreateItem aloca um slot para o item de criação especificado, opcionalmente alocando espaço para e copiando os dados de criar item também. Essa função pressupõe que o chamador está serializando várias alterações na lista de entrada de criação.

Sintaxe

KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
  [in]           KSDEVICE_HEADER       Header,
  [in]           PKSOBJECT_CREATE_ITEM CreateItem,
  [in]           BOOLEAN               AllocateEntry,
  [in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);

Parâmetros

[in] Header

Aponta para o cabeçalho do dispositivo no qual anexar o item create.

[in] CreateItem

Contém o item create a ser anexado.

[in] AllocateEntry

Indica se o ponteiro de criação de item passado deve ser anexado diretamente ao cabeçalho ou se uma cópia dele deve ser feita.

[in, optional] ItemFreeCallback

Opcionalmente, contém um ponteiro para uma função KStrItemFreeCallback definida por minidriver a ser chamada quando a entrada de criação está sendo destruída ao liberar o cabeçalho do dispositivo. Isso só é válido quando AllocateEntry é TRUE.

Retornar valor

Retorna STATUS_SUCCESS se um novo item foi alocado e anexado. Caso contrário, retornará STATUS_INSUFFICIENT_RESOURCES.

Requisitos

Confira também

KStrItemFreeCallback