Método IKsTopology::CreateNodeInstance (ksproxy.h)

O método CreateNodeInstance solicita um objeto de filtro KS para abrir um objeto de nó de topologia.

Sintaxe

HRESULT CreateNodeInstance(
  [in]           ULONG       NodeId,
  [in]           ULONG       Flags,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] IUnknown    *UnkOuter,
  [in]           REFGUID     InterfaceId,
  [out]          LPVOID      *Interface
);

Parâmetros

[in] NodeId

Identificador do objeto de nó de topologia a ser aberto.

[in] Flags

Um bitmask enumerando o tipo de objeto de nó de topologia. Nenhum sinalizador está definido no momento.

[in] DesiredAccess

Uma máscara de bits ACCESS_MASK especificando o tipo de acesso que o chamador requer para o objeto de nó de topologia. Consulte ZwCreateFile para obter uma descrição de cada valor de direito de acesso.

[in, optional] UnkOuter

Ponteiro para uma interface IUnknown que dá suporte à interface do nó de topologia.

[in] InterfaceId

Identificador da interface do nó de topologia que está sendo solicitada.

[out] Interface

Ponteiro para uma variável que recebe o ponteiro de interface solicitado em InterfaceId. Após o retorno bem-sucedido, *Interface contém o ponteiro de interface solicitado para o objeto . Se o objeto não der suporte à interface especificada em InterfaceId, *Interface será definida como NULL.

Retornar valor

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

Requisitos

Requisito Valor
Plataforma de Destino DesktopMobile
Cabeçalho ksproxy.h (inclua Ksproxy.h)

Confira também

ACCESS_MASK

IKsTopology

ZwCreateFile