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

Artículo
02/26/2024

El método CreateNodeInstance solicita un objeto de filtro KS para abrir un objeto de nodo de topología.

Sintaxis

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 del objeto de nodo de topología que se va a abrir.

[in] Flags

Máscara de bits que enumera el tipo de objeto de nodo de topología. Actualmente no hay marcas definidas.

[in] DesiredAccess

Máscara de bits de ACCESS_MASK que especifica el tipo de acceso que el autor de la llamada requiere para el objeto de nodo de topología. Consulte ZwCreateFile para obtener una descripción de cada valor de acceso correcto.

[in, optional] UnkOuter

Puntero a una interfaz IUnknown que admite la interfaz del nodo de topología.

[in] InterfaceId

Identificador de la interfaz del nodo de topología que se solicita.

[out] Interface

Puntero a una variable que recibe el puntero de interfaz solicitado en InterfaceId. Tras la devolución correcta, *Interface contiene el puntero de interfaz solicitado al objeto . Si el objeto no admite la interfaz especificada en InterfaceId, *Interface se establece en NULL.