Método IKsPin::KsGetCurrentCommunication (ksproxy.h)

  • Artículo

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)

Consulte también

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW