PFNKSINTERSECTHANDLEREX callback function (ks.h)

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

See also

KSDATARANGE

KSFILTER

KSPIN_DESCRIPTOR_EX

KSPROPERTY_PIN_DATAINTERSECTION

KSP_PIN

KsPinDataIntersectionEx