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 Pin-ist. Wenn Pin- die Kopierquelle ist, legt AVStream diesen Parameter auf NULL-fest.
[out] DelegateBranch
Ein Zeiger auf einen Zeiger auf eine KSPIN- Struktur, von der Pin delegierte Frames empfängt. Wenn Pin der Delegator ist, legt AVStream diesen Parameter auf NULL-fest.
Rückgabewert
Nichts
Bemerkungen
Filterzentrierte Filter empfangen ä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 Splitters.
Alle Pins funktionieren unabhängig im Kontext eines pinzentrierten Filters. Daher ist ein Minidriver, der KsPinGetCopyRelationships aufruft, dafür verantwortlich ist, sicherzustellen, dass die entsprechende Synchronisierung vor der Anrufzeit ausgeführt wird.
Um die Sicherheit beim Aufrufen von KsPinGetCopyRelationshipszu gewährleisten, rufen Sie entweder den Steuerelementmutex ab (verwenden Sie diesen Mechanismus nicht in einer Verarbeitungssendung), 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 Verarbeitung und Filter-Centric Verarbeitung.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |