KsPinRegisterHandshakeCallback-Funktion (ks.h)

Artikel
02/26/2024

Die KsPinRegisterHandshakeCallback-Funktion registriert eine vom Minidriver bereitgestellte Rückrufroutine für einen bestimmten Pin. AVStream ruft die Rückrufroutine auf, wenn sie eine Handshakeanforderung für den Pin empfängt, die ein Protokoll angibt, das AVStream standardmäßig nicht verarbeitet.

Syntax

void KsPinRegisterHandshakeCallback(
  [in] PKSPIN            Pin,
  [in] PFNKSPINHANDSHAKE Handshake
);

Parameter

[in] Pin

Ein Zeiger auf die KSPIN-Struktur , für die ein Handshake-Rückruf registriert werden soll.

[in] Handshake

Ein Zeiger auf eine vom Minidriver bereitgestellte AVStrMiniPinHandshake-Routine , die aufgerufen werden soll, wenn AVStream eine Protokoll-Handshakeanforderung für Pin empfängt, die nicht verarbeitet wird.

Rückgabewert

Keine

Bemerkungen

Pins, die private Protokollverbindungen mit anderen AVStream-Pins unterstützen, sollten einen Handshake-Rückruf registrieren.

Minidriver, die private Protokolle zwischen einer bestimmten Pin und einem anderen AVStream-Pin unterstützen, sollten diese Routine so schnell wie möglich aufrufen, um einen Rückruf zu registrieren. Wenn dann ein anderer Pin einen Handshake anfordert, kann der Minidriver die Anforderung zurückgeben.

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