Método IDeviceTopology::GetSignalPath (devicetopology.h)

Artículo
08/23/2023

El método GetSignalPath obtiene una lista de partes de la ruta de acceso de señal que vincula dos partes, si la ruta de acceso existe.

Sintaxis

HRESULT GetSignalPath(
  [in]  IPart      *pIPartFrom,
  [in]  IPart      *pIPartTo,
  [in]  BOOL       bRejectMixedPaths,
  [out] IPartsList **ppParts
);

Parámetros

[in] pIPartFrom

Puntero a la parte "from". Este parámetro es un puntero a la interfaz IPart de la parte al principio de la ruta de acceso de la señal.

[in] pIPartTo

Puntero a la parte "a". Este parámetro es un puntero a la interfaz IPart de la parte al final de la ruta de acceso de la señal.

[in] bRejectMixedPaths

Especifica si se rechazan las rutas de acceso que contienen datos mixtos. Si bRejectMixedPaths es TRUE (distinto de cero), el método omite cualquier ruta de acceso de datos que contenga un mezclador (es decir, un nodo de procesamiento que suma dos o más señales de entrada). Si es FALSE, el método intentará encontrar una ruta de acceso que conecte las partes "from" y "to" independientemente de si la ruta de acceso contiene un mezclador.

[out] ppParts

Puntero a una variable de puntero en la que el método escribe la dirección de una instancia de interfaz IPartsList . Esta interfaz encapsula la lista de partes de la ruta de acceso de señal que conecta la parte "from" a la parte "to". A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetSignalPath , *ppParts es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_POINTER	El parámetro pIPartFrom, pIPartTo o ppParts es NULL.
E_NOTFOUND	No se encontró ninguna ruta de acceso que vincule las dos partes.
E_NOINTERFACE	El parámetro pIPartFrom o pIPartTo no apunta a una interfaz IPart válida.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Este método crea una instancia de interfaz IPartsList que contiene una lista de las partes que se encuentran a lo largo de la ruta de acceso de señal especificada. Las partes de la lista de piezas se ordenan según sus posiciones relativas en la ruta de señal. La parte "to" es el primer elemento de la lista y la parte "from" es el último elemento de la lista.

Si la lista contiene n partes, las partes "to" y "from" se identifican por los índices de lista 0 y n– 1, respectivamente. Para obtener el número de partes de una lista de partes, llame al método IPartsList::GetCount . Para recuperar una parte por su índice, llame al método IPartsList::GetPart .

Las partes de la ruta de acceso de señal deben formar parte de la misma topología del dispositivo. La ruta de acceso no puede abarcar límites entre topologías de dispositivo.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h