Método IKsPin::KsGetCurrentCommunication (ksproxy.h)
El método KsGetCurrentCommunication recupera la dirección de comunicación actual, la interfaz y el medio de un pin.
Sintaxis
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
Parámetros
[out, optional] Communication
Puntero a una variable que recibe uno de los siguientes valores del tipo enumerado KSPIN_COMMUNICATION que describe la dirección de comunicación actual de un pin:
| Valor | Descripción |
|---|---|
| KSPIN_COMMUNICATION_NONE | El generador de patillas no crea ninguna instancia de anclaje. |
| KSPIN_COMMUNICATION_SINK | El generador de patillas crea instancias de patillas receptoras IRP. Estos pines solo se pueden conectar a patillas de origen IRP. |
| KSPIN_COMMUNICATION_SOURCE | El generador de patillas crea instancias de patillas de origen IRP. Estos pines solo se pueden conectar a patillas receptoras IRP. |
| KSPIN_COMMUNICATION_BOTH | El generador de patillas crea instancias de patillas que son receptores IRP y orígenes IRP. |
| KSPIN_COMMUNICATION_BRIDGE | El pin no se puede conectar a otros pines, pero se pueden crear instancias en él para recibir solicitudes de E/S que no sean KS. |
[out, optional] Interface
Puntero a una variable que recibe una estructura de KSPIN_INTERFACE que describe la interfaz actual de un pin.
[out, optional] Medium
Puntero a una variable que recibe una estructura de KSPIN_MEDIUM que describe el medio actual para un pin.
Valor devuelto
Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.
Comentarios
Los patillas de origen envían IRP a las patillas receptoras. No confunda la dirección de comunicación con la dirección del flujo de datos. (Consulte KSPROPERTY_PIN_DATAFLOW). Un pin de origen puede leer o escribir datos, y un pin receptor puede tener datos leídos o escritos desde él.
La dirección de comunicación actual, la interfaz y el medio de un pin son un subconjunto de los disponibles para el pin y se seleccionan cuando se crea el identificador de patilla.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | ksproxy.h (incluya Ksproxy.h) |