KsPinGetCopyRelationships-Funktion (ks.h)

Die KsPinGetCopyRelationships-Funktion gibt Kopierbeziehungsinformationen für einen Pin zurück, der in einem pinzentrierten Filter enthalten ist.

Syntax

void KsPinGetCopyRelationships(
  [in]  PKSPIN Pin,
  [out] PKSPIN *CopySource,
  [out] PKSPIN *DelegateBranch
);

Parameter

[in] Pin

Ein Zeiger auf die KSPIN-Struktur , aus der Sie Kopierinformationen abrufen möchten.

[out] CopySource

Ein Zeiger auf einen Zeiger auf eine KSPIN-Struktur , die die Kopierquelle für Anheften ist. Wenn Pin die Kopierquelle ist, legt AVStream diesen Parameter auf NULL fest.

[out] DelegateBranch

Ein Zeiger auf einen Zeiger auf eine KSPIN-Struktur , die der Pin ist, von dem Pin delegierte Frames empfängt. Wenn Pin der Delegator ist, legt AVStream diesen Parameter auf NULL fest.

Rückgabewert

Keine

Bemerkungen

Filterzentrische Filter erhalten ähnliche CopySource - und DelegateBranch-Informationen , wenn AVStream die AVStrMiniFilterProcess-Funktion des Minidrivers mit einem Array von KSPROCESSPIN_INDEXENTRY Strukturen aufruft.

Der einzige Unterschied besteht darin, dass KsPinGetCopyRelationships Zeiger auf PKSPIN und nicht auf PKSPROCESSPIN zurückgibt. Weitere Informationen zu den Parametern CopySource und DelegateBranch finden Sie unter AVStream-Splitter.

Alle Pins arbeiten unabhängig im Kontext eines pinzentrischen Filters. Daher ist ein Minidriver, der KsPinGetCopyRelationships aufruft , dafür verantwortlich, sicherzustellen, dass die entsprechende Synchronisierung vor der Anrufzeit ausgeführt wird.

Um die Sicherheit beim Aufrufen von KsPinGetCopyRelationships zu gewährleisten, rufen Sie entweder den Steuerungsmutex ab (verwenden Sie diesen Mechanismus nicht in einer Verarbeitungsversendung), oder stellen Sie sicher, dass der Pin beim Aufrufen oder Verwenden der abgerufenen Informationen nicht unter KSSTATE_PAUSE wechselt. Weitere Informationen zu Mutexes finden Sie unter Mutexes in AVStream.

Weitere Informationen finden Sie unter Pin-Centric Processing und Filter-Centric Processing.

Anforderungen

Weitere Informationen

KSPIN_DESCRIPTOR_EX

KSPROCESSPIN