KsPinRegisterHandshakeCallback, fonction (ks.h)

Article
02/26/2024

La fonction KsPinRegisterHandshakeCallback enregistre une routine de rappel fournie par minidriver pour une broche donnée. AVStream appelle la routine de rappel lorsqu’elle reçoit une demande de négociation pour l’épingle qui spécifie un protocole qu’AVStream ne gère pas par défaut.

Syntaxe

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

Paramètres

[in] Pin

Pointeur vers la structure KSPIN pour laquelle inscrire un rappel de liaison.

[in] Handshake

Pointeur vers une routine AVStrMiniPinHandshake fournie par minidriver à appeler quand AVStream reçoit une demande d’établissement d’une liaison de protocole sur Pin qu’il ne gère pas.

Valeur de retour

None

Remarques

Les broches qui prennent en charge les connexions de protocole privé avec d’autres broches AVStream doivent inscrire un rappel de liaison.

Les minidrivers qui prennent en charge les protocoles privés entre une broche donnée et une autre broche AVStream doivent appeler cette routine dès que possible pour inscrire un rappel. Ensuite, si une autre épingle demande une liaison, le minidriver peut retourner la demande.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	PASSIVE_LEVEL