KsPinGetReferenceClockInterface-Funktion (ks.h)
Die KsPinGetReferenceClockInterface--Funktion gibt eine COM-Formatschnittstelle zur Referenzuhr zurück, die Pin-zugeordnet ist. Dieser Schnittstellenzeiger ist ein IKsReferenceClock Schnittstelle.
Syntax
KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
[in] PKSPIN Pin,
[out] PIKSREFERENCECLOCK *Interface
);
Parameter
[in] Pin
Ein Zeiger auf die KSPIN Struktur, für die die Referenzuhrschnittstelle zurückgegeben werden soll.
[out] Interface
Ein Zeiger auf einen Speicherspeicherort, der die Adresse eines IKsReferenceClock Schnittstelle empfängt. Dies ist eine COM-Stilschnittstelle mit einer zugeordneten Verweisanzahl. Minidriver müssen die Schnittstelle freigeben, wenn sie damit fertig ist.
Rückgabewert
KsPinGetReferenceClockInterface gibt STATUS_SUCCESS zurück und legt die Adresse der IKsReferenceClock Schnittstelle in Interface zurück, wenn der Pin die Uhr implementiert oder die Benachrichtigung über die Masteruhr über die eigenschaft KSPROPERTY_STREAM_MASTERCLOCK empfangen hat. Gibt STATUS_DEVICE_NOT_READY zurück, wenn der Pin noch keine Benachrichtigung über die Masteruhr erhalten hat.
Bemerkungen
Die häufigste Zeit zum Aufrufen KsPinGetReferenceClockInterface- befindet sich in einem Zustandsübergang zu KSSTATE_ACQUIRE.
Weitere Informationen zur Verwendung der IKsReferenceClock Schnittstelle, die von dieser Routine zurückgegeben wird, finden Sie unter AVStream Clocks.
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 |
| IRQL- | PASSIVE_LEVEL |