Função KsAddObjectCreateItemToObjectHeader (ks.h)

A função KsAddObjectCreateItemToObjectHeader adiciona o item de criação especificado a um item vazio na lista de itens de criação alocados anteriormente para esse cabeçalho de objeto. Um item vazio é assinado por uma função de expedição de criação NULL na entrada. Essa função pressupõe que o chamador está serializando várias alterações na lista criar itens.

Sintaxe

KSDDKAPI NTSTATUS KsAddObjectCreateItemToObjectHeader(
  [in]           KSOBJECT_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parâmetros

[in] Header

Aponta para o cabeçalho do objeto que contém a tabela child-create alocada anteriormente.

[in] Create

Especifica a função create dispatch a ser usada.

[in] Context

Especifica o parâmetro de contexto.

[in] ObjectClass

Especifica um ponteiro para uma cadeia de caracteres terminada em NULL que é usada para comparação em solicitações de criação. Esse ponteiro deve permanecer válido enquanto o objeto estiver ativo.

[in, optional] SecurityDescriptor

Especifica o descritor de segurança. Isso deve permanecer válido enquanto o objeto estiver ativo.

Retornar valor

A função KsAddObjectCreateItemToObjectHeader retorna STATUS_SUCCESS se um slot de item de criação vazio foi encontrado e o item foi adicionado. Se não tiver êxito, ele retornará STATUS_ALLOTTED_SPACE_EXCEEDED.

Requisitos