PFNKSINTERSECTHANDLEREX callback function (ks.h)

Article
03/15/2022

AVStream calls a minidriver's AVStrMiniIntersectHandlerEx routine to determine the highest quality intersection of two data ranges.

Syntax

PFNKSINTERSECTHANDLEREX Pfnksintersecthandlerex;

NTSTATUS Pfnksintersecthandlerex(
  [in]  PVOID Context,
  [in]  PIRP Irp,
  [in]  PKSP_PIN Pin,
  [in]  PKSDATARANGE DataRange,
  [in]  PKSDATARANGE MatchingDataRange,
  [in]  ULONG DataBufferSize,
  [out] PVOID Data,
  [out] PULONG DataSize
)
{...}

Parameters

[in] Context

Pointer to the Context member of the corresponding KSFILTER structure.

[in] Irp

Pointer to the IRP containing the intersection request.

[in] Pin

Pointer to a structure of type KSP_PIN that was passed in the intersection property request.

[in] DataRange

Pointer to an array of KSDATARANGE structures.

[in] MatchingDataRange

Pointer to an array of KSDATARANGE structures to match to DataRange.

[in] DataBufferSize

Specifies a value of type ULONG that contains the size of the data buffer.

[out] Data

Pointer to an optional data buffer in which the minidriver outputs the intersection.

[out] DataSize

Pointer to a value of type ULONG specifying the size of the data buffer.

Return value

If the callback finds a match, return STATUS_SUCCESS. Otherwise return STATUS_NO_MATCH.

Remarks

The minidriver specifies this routine's address in the IntersectHandler member of a KSPIN_DESCRIPTOR_EX structure.

Requirements

Requirement	Value
Target Platform	Desktop
Header	ks.h