Função KsCreateTopologyNode2 (ks.h)

Artigo
03/05/2024

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

Com suporte a partir de 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 que é usado para criar o identificador de nó de topologia.

[in] DesiredAccess

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

[out] NodeHandle

Local para o identificador do nó de topologia.

Retornar valor

Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.

Comentários

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
IRQL	PASSIVE_LEVEL

Confira também

Compartilhar via