Edit

PFNKSINTERSECTHANDLER callback function (ks.h)

  • Article

A streaming minidriver's KStrIntersectHandler routine is called to compare a data range to determine if there is an intersection, and if so, the data format of the intersection.

Syntax

PFNKSINTERSECTHANDLER Pfnksintersecthandler;

NTSTATUS Pfnksintersecthandler(
  [in]            PIRP Irp,
  [in]            PKSP_PIN Pin,
  [in]            PKSDATARANGE DataRange,
  [out, optional] PVOID Data
)
{...}

Parameters

[in] Irp

Specifies the IRP that handles the property request.

[in] Pin

Specifies the specific property being queried and the pin factory identifier that was validated.

[in] DataRange

Specifies the current data range to compare. The data range has been validated as either matching a particular range on the pin or as a wildcard match.

[out, optional] Data

Specifies the data format returned, or the size, in bytes, of the data format.

Return value

Returns STATUS_SUCCESS if there is a data intersection that fits in the supplied buffer. Otherwise, one of the following values is returned.

Return code Description
STATUS_BUFFER_OVERFLOW For successful size queries.
STATUS_BUFFER_TOO_SMALL If the supplied buffer is too small.
STATUS_NO_MATCH If there is no intersection.

Requirements

Requirement Value
Target Platform Desktop
Header ks.h (include Ks.h)

See also

KsPinDataIntersection