IMiniport::DataRangeIntersection

The DataRangeIntersection method determines the highest quality intersection of two data ranges.

NTSTATUS
  DataRangeIntersection(
    IN ULONG  PinId,
    IN PKSDATARANGE  DataRange,
    IN PKSDATARANGE  MatchingDataRange,
    IN ULONG  OutputBufferLength,
    OUT PVOID  ResultantFormat  OPTIONAL,
    OUT PULONG  ResultantFormatLength
    );

Parameters

PinId

Specifies the pin ID. This parameter identifies the pin factory for which the data intersection is being determined. If the filter contains N pin factories, valid pin IDs range from 0 to N-1.

DataRange

Pointer to a KSDATARANGE structure that contains the data range submitted by the client in the data-range intersection property request.

MatchingDataRange

Pointer to a KSDATARANGE structure that contains the miniport driver's data range that is to be compared to the client's data range.

OutputBufferLength

Specifies the size in bytes of the buffer pointed to by the ResultantFormat parameter. The caller can specify OutputBufferLength as zero to query for the required buffer size. See the following Comments section.

ResultantFormat

Pointer to the buffer into which the method writes the resultant format. If this parameter is NULL, the OutputBufferLength parameter must be zero. If non-NULL, this parameter must point to a buffer that is large enough to contain the number bytes specified in OutputBufferLength.

ResultantFormatLength

Output pointer for the resultant-format length. This parameter points to a caller-allocated ULONG variable into which the method writes the length of the resultant format. This is the size in bytes of the resultant format that is written to the buffer pointed to by ResultantFormat. This size must be less than or equal to OutputBufferLength (unless OutputBufferLength is zero; see the following Comments section).

Return Value

DataRangeIntersection returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code. The following table shows some of the possible return status codes.

Headers

Declared in portcls.h. Include portcls.h.

Comments

The DataRangeIntersection method is the miniport driver's data-intersection handler. The port driver calls this method when it receives a data-range intersection property request (see KSPROPERTY_PIN_DATAINTERSECTION) and the target for the request is a pin factory on a filter instance that the miniport driver implements.

The ResultantFormatBuffer parameter points to a buffer that begins with a KSDATAFORMAT_WAVEFORMATEX structure. Note that the WaveFormatEx member of this structure can be extended to include additional format information (for example, a channel configuration mask). For more information, see WAVEFORMATEXTENSIBLE.

The ResultantFormat parameter is optional and can be specified as NULL, in which case OutputBufferLength must be specified as zero. The caller can query for the required buffer length by making an initial call to DataRangeIntersection with an OutputBufferLength value of zero. The method responds by writing the required buffer length to the location pointed to by ResultantFormatLength and returning status code STATUS_BUFFER_OVERFLOW. The caller can then allocate a buffer of the required size and specify this buffer in a second call to DataRangeIntersection.

See Also

KSDATARANGE, KSPROPERTY_PIN_DATAINTERSECTION, KSDATAFORMAT_WAVEFORMATEX, WAVEFORMATEXTENSIBLE