Compartilhar via

Função KsAddObjectCreateItemToDeviceHeader (ks.h)

  • Artigo

A função KsAddObjectCreateItemToDeviceHeader 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 dispositivo. 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 KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_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 dispositivo que contém a tabela de criação filho alocada anteriormente.

[in] Create

Especifica a função create dispatch.

[in] Context

Especifica o parâmetro de contexto.

[in] ObjectClass

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

[in, optional] SecurityDescriptor

Especifica o descritor de segurança. Isso deve permanecer válido enquanto o objeto de dispositivo estiver ativo. Esse parâmetro é opcional.

Retornar valor

A função KsAddObjectCreateItemToDeviceHeader 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

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib