IKsPin::KsGetCurrentCommunication-Methode (ksproxy.h)
Die KsGetCurrentCommunication-Methode ruft die aktuelle Kommunikationsrichtung, schnittstelle und das medium eines Pins ab.
Syntax
HRESULT KsGetCurrentCommunication(
[out, optional] KSPIN_COMMUNICATION *Communication,
[out, optional] KSPIN_INTERFACE *Interface,
[out, optional] KSPIN_MEDIUM *Medium
);
Parameter
[out, optional] Communication
Zeiger auf eine Variable, die einen der folgenden Werte vom KSPIN_COMMUNICATION aufgezählten Typ empfängt, der die aktuelle Kommunikationsrichtung für einen Pin beschreibt:
| Wert | BESCHREIBUNG |
|---|---|
| KSPIN_COMMUNICATION_NONE | Die Pinfactory erstellt keine Pininstanzen. |
| KSPIN_COMMUNICATION_SINK | Die Pinfactory erstellt Instanzen von IRP-Senkenpins. Solche Pins können nur mit IRP-Quellpins verbunden werden. |
| KSPIN_COMMUNICATION_SOURCE | Die Pinfactory erstellt Instanzen von IRP-Quellpins. Solche Pins können nur mit IRP-Senkenstiften verbunden werden. |
| KSPIN_COMMUNICATION_BOTH | Die Pinfactory erstellt Instanzen von Pins, die sowohl IRP-Senken als auch IRP-Quellen sind. |
| KSPIN_COMMUNICATION_BRIDGE | Der Pin kann keine Verbindung mit anderen Pins herstellen, aber es können Instanzen erstellt werden, um E/A-Anforderungen ohne KS zu empfangen. |
[out, optional] Interface
Zeiger auf eine Variable, die eine KSPIN_INTERFACE-Struktur empfängt, die die aktuelle Schnittstelle für einen Pin beschreibt.
[out, optional] Medium
Zeiger auf eine Variable, die eine KSPIN_MEDIUM-Struktur empfängt, die das aktuelle Medium für eine Pin beschreibt.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Quellpins senden IRPs an Senkenpins. Verwechseln Sie die Kommunikationsrichtung nicht mit der Datenflussrichtung. (Siehe KSPROPERTY_PIN_DATAFLOW.) Eine Quell-Pin kann Daten lesen oder schreiben, und eine Senkennadel kann Daten enthalten, die darin gelesen oder daraus geschrieben werden.
Die aktuelle Kommunikationsrichtung, die Schnittstelle und das Medium eines Pins sind eine Teilmenge derjenigen, die für den Pin verfügbar sind, und werden ausgewählt, wenn der Stiftziehpunkt erstellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ksproxy.h (include Ksproxy.h) |