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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |