KsPinHandshake function (ks.h)
The KsPinHandshake function attempts a protocol handshake with a connected pin.
Syntax
KSDDKAPI NTSTATUS KsPinHandshake(
[in] PKSPIN Pin,
[in] PKSHANDSHAKE In,
[out] PKSHANDSHAKE Out
);
Parameters
[in] Pin
A pointer to the KSPIN structure that is initiating the handshake. The handshake request is passed on to the pin connected to this object.
[in] In
A pointer to the KSHANDSHAKE structure containing the handshake information to be passed to the connected pin.
[out] Out
A pointer to a KSHANDSHAKE structure that is filled in with handshake information by the connected pin.
Return value
KsPinHandshake returns STATUS_SUCCESS if the connected pin is accepting the negotiated connection. Otherwise, it returns an appropriate error code.
Remarks
Protocol handshakes can be used to negotiate private interfaces between two pins that are both AVStream pins.
Connections between AVStream pins are performed using this type of handshake.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions. |
| Target Platform | Desktop |
| Header | ks.h (include Ks.h) |
| IRQL | PASSIVE_LEVEL |