Compartilhar via


Função KsCreateTopologyNode2 (ks.h)

Cria um identificador para uma instância de nó de topologia.

Com suporte a partir do Windows 8.

Sintaxe

KSDDKAPI HRESULT KsCreateTopologyNode2(
  [in]  HANDLE         ParentHandle,
  [in]  PKSNODE_CREATE NodeCreate,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        NodeHandle
);

Parâmetros

[in] ParentHandle

Especifica o identificador para o pai no qual o nó é criado.

[in] NodeCreate

Uma estrutura KSNODE_CREATE que descreve o conjunto de informações usado para criar o identificador de nó de topologia.

[in] DesiredAccess

Especifica um ACCESS_MASK indicando o acesso desejado ao objeto. Normalmente, isso é GENERIC_READ e/ou GENERIC_WRITE.

[out] NodeHandle

Local para o identificador do nó de topologia.

Valor de retorno

Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.

Observações

Esta é uma nova versão da função KsCreateTopologyNode e usa o agente do dispositivo para criar o identificador para o objeto de streaming do kernel. Além disso, a função COM (Component Object Model) CoInitialize deve ser chamada antes que essa função seja chamada.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8
servidor com suporte mínimo Windows Server 2012
da Plataforma de Destino Universal
cabeçalho ks.h (incluir Ks.h)
IRQL PASSIVE_LEVEL

Consulte também

ACCESS_MASK

CoInitialize

KSNODE_CREATE

KsCreateTopologyNode