IKsPin::KsGetCurrentCommunication-Methode (ksproxy.h)

Die KsGetCurrentCommunication Methode ruft die aktuelle Kommunikationsrichtung, Schnittstelle und 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 aus dem KSPIN_COMMUNICATION aufgezählten Typ empfängt, der die aktuelle Kommunikationsrichtung für einen Pin beschreibt:

Wert	Beschreibung
KSPIN_COMMUNICATION_NONE	Die Pin-Factory erstellt keine Pininstanzen.
KSPIN_COMMUNICATION_SINK	Die Pin-Factory erstellt Instanzen von IRP-Sink-Pins. Solche Pins können nur mit IRP-Quell-Pins verbunden werden.
KSPIN_COMMUNICATION_SOURCE	Die Pinfactory erstellt Instanzen von IRP-Quell-Pins. 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, es können jedoch Instanzen erstellt werden, um Nicht-KS-E/A-Anforderungen 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 einen Pin beschreibt.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Quell-Pins senden IRPs an Senken-Pins. Verwechseln Sie die Kommunikationsrichtung nicht mit der Datenflussrichtung. (Siehe KSPROPERTY_PIN_DATAFLOW.) Eine Quellnadel kann Daten lesen oder schreiben, und eine Senkennadel kann Daten lesen oder daraus schreiben.

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 Pinziehpunkt erstellt wird.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	ksproxy.h (include Ksproxy.h)

Siehe auch

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW