PFNKSPINHANDSHAKE callback function (ks.h)

An AVStream minidriver's AVStrMiniPinHandshake routine is called when AVStream receives a protocol handshake request that it does not handle.

Syntax

PFNKSPINHANDSHAKE Pfnkspinhandshake;

NTSTATUS Pfnkspinhandshake(
  PKSPIN Pin,
  PKSHANDSHAKE In,
  PKSHANDSHAKE Out
)
{...}

Parameters

Pin

Describes the PKSPIN parameter Pin.

In

Describes the PKSHANDSHAKE parameter In.

Out

Describes the PKSHANDSHAKE parameter Out.

Return value

Returns STATUS_SUCCESS if the pin supports the requested protocol. Otherwise, it should return STATUS_INVALID_DEVICE_REQUEST.

Remarks

The minidriver specifies this routine's address in the Handshake parameter of a call to KsPinRegisterHandshakeCallback.

Requirements

Requirement Value
Minimum supported client Available in DirectX 8.0 and later versions.
Target Platform Desktop
Header ks.h (include Ks.h)

See also

KSHANDSHAKE

KSIDENTIFIER

KsPinRegisterHandshakeCallback