Função KsAddObjectCreateItemToDeviceHeader (ks.h)

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

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 criar expedição.

[in] Context

Especifica o parâmetro de contexto.

[in] ObjectClass

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

[in, optional] SecurityDescriptor

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

Valor de retorno

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
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib