KsPinGetReferenceClockInterface-Funktion (ks.h)
Die KsPinGetReferenceClockInterface-Funktion gibt eine COM-Stilschnittstelle für die Der Pin zugeordnete Referenzuhr zurück. Bei diesem Schnittstellenzeiger handelt es sich um eine 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 einer IKsReferenceClock-Schnittstelle empfängt. Hierbei handelt es sich um eine COM-Formatschnittstelle mit einer zugeordneten Verweisanzahl. Minidriver müssen die Schnittstelle freigeben, wenn sie fertig ist.
Rückgabewert
KsPinGetReferenceClockInterface gibt STATUS_SUCCESS zurück und legt die Adresse der IKsReferenceClock-Schnittstelle in Interface ab, wenn der Pin die Uhr implementiert oder eine Benachrichtigung über die master Uhr über die KSPROPERTY_STREAM_MASTERCLOCK-Eigenschaft empfangen hat. Gibt STATUS_DEVICE_NOT_READY zurück, wenn die Pin noch keine Benachrichtigung über die master Uhr erhalten hat.
Hinweise
Die häufigste Zeit zum Aufrufen von 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |