Metodo IKsPin::KsGetCurrentCommunication (ksproxy.h)
Il metodo KsGetCurrentCommunication recupera la direzione di comunicazione, l'interfaccia e il supporto correnti di un pin.
Sintassi
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
Parametri
[out, optional] Communication
Puntatore a una variabile che riceve uno dei valori seguenti dal tipo enumerato KSPIN_COMMUNICATION che descrive la direzione di comunicazione corrente per un pin:
| Valore | Descrizione |
|---|---|
| KSPIN_COMMUNICATION_NONE | La factory di pin non crea istanze di pin. |
| KSPIN_COMMUNICATION_SINK | La factory pin crea istanze di pin sink IRP. Tali pin possono essere connessi solo ai pin di origine IRP. |
| KSPIN_COMMUNICATION_SOURCE | La factory di pin crea istanze di pin di origine IRP. Tali pin possono essere connessi solo ai pin sink IRP. |
| KSPIN_COMMUNICATION_BOTH | La factory pin crea istanze di pin che sono sia sink IRP che origini IRP. |
| KSPIN_COMMUNICATION_BRIDGE | Il pin non può connettersi ad altri pin, ma le istanze possono essere create per ricevere richieste di I/O non KS. |
[out, optional] Interface
Puntatore a una variabile che riceve una struttura KSPIN_INTERFACE che descrive l'interfaccia corrente per un pin.
[out, optional] Medium
Puntatore a una variabile che riceve una struttura KSPIN_MEDIUM che descrive il supporto corrente per un pin.
Valore restituito
Restituisce NOERROR se ha esito positivo; in caso contrario, restituisce un codice di errore.
Osservazioni
I pin di origine inviano i runtime di integrazione ai pin sink. Non confondere la direzione di comunicazione con la direzione del flusso di dati. Vedere KSPROPERTY_PIN_DATAFLOW.) Un pin di origine può leggere o scrivere dati e un pin sink potrebbe avere dati letti o scritti da esso.
La direzione di comunicazione, l'interfaccia e il supporto correnti di un pin sono un subset di quelli disponibili per il pin e vengono selezionati quando viene creato l'handle di pin.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | ksproxy.h (include Ksproxy.h) |