KsStreamPointerScheduleTimeout-Funktion (ks.h)

Artikel
03/01/2024

Die KsStreamPointerScheduleTimeout-Funktion registriert einen Timeoutrückruf bei AVStream für den angegebenen Streamzeiger.

Syntax

void KsStreamPointerScheduleTimeout(
  [in] PKSSTREAM_POINTER  StreamPointer,
  [in] PFNKSSTREAMPOINTER Callback,
  [in] ULONGLONG          Interval
);

Parameter

[in] StreamPointer

Ein Zeiger auf eine KSSTREAM_POINTER-Struktur , die den Datenstromzeiger darstellt, für den ein Timeout registriert werden soll.

[in] Callback

Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniTimeoutCallback-Routine . Wenn der Streamzeiger nicht gelöscht wurde oder das Timeout vor Ablauf des Intervalls abgebrochen wurde, ruft AVStream diese Routine unmittelbar nach Ablauf des Intervalls auf.

[in] Interval

Gibt das Intervall in 100 Nanosekundeneinheiten vom aktuellen Zeitpunkt bis zum Zeitpunkt an, zu dem das Timeout auftritt.

Rückgabewert

Keine

Bemerkungen

Es ist sicher, KsStreamPointerScheduleTimeout für einen Streamzeiger aufzurufen, für den bereits ein Timeout geplant ist. In diesem Fall bricht AVStream das vorherige Timeout ab und ersetzt es durch das neue Timeout.

Wenn Sie KsStreamPointerScheduleTimeout aufrufen, während sich die dem KSSTREAM_POINTER zugeordnete Pin noch im Zustand Pause befindet, wird das geplante Timeout möglicherweise erst ausgelöst, wenn später im Ausführungszustand ein anderes Timeout geplant wird. An diesem Punkt ist es möglich, dass alle Timeouts, die während der Pause geplant wurden, aktiv werden und sofort in einer Kette ausgelöst werden. Siehe auch Stream Zeiger.