Edit

PFNAVCINTERSECTHANDLER callback function (avc.h)

  • Article

The AV/C intersect handler determines if the data ranges are compatible. This is a user-defined function based on the following prototype:

Syntax

typedef NTSTATUS ( *PFNAVCINTERSECTHANDLER)(
  _In_      PVOID        Context,
  _In_      ULONG        PinId,
  _In_      PKSDATARANGE CallerDataRange,
  _In_      PKSDATARANGE DescriptorDataRange,
  _In_      ULONG        DataBufferSize,
  _Out_opt_ PVOID        Data,
  _Out_     PULONG       ReportedDataSize
);

Parameters

[in] Context

An optional value expected by the intersect handler. This value is either provided by the subunit driver (if the subunit driver provides the intersect handler), or by the lower driver providing the intersect handler.

[in] PinId

Specifies the offset (or ID) of the pin for which the intersection is being done.

[in] DataRange

[in] MatchingDataRange

[in] DataBufferSize

The size of the buffer passed by the Data member. If this is nonzero, then the intersect handler should attempt to return the data format resulting from a matching pair of data ranges. If this is zero, then the intersect handler should provide the required buffer size in ReportedDataSize, and return STATUS_BUFFER_OVERFLOW.

[out, optional] Data

An optional buffer to receive the data format resulting from a matching pair of data ranges. This member is ignored if DataBufferSize is zero.

[out] DataSize

Return value

The intersect handler should return STATUS_SUCCESS if the data ranges are compatible, and there was enough buffer space to return the resulting format.

Return code Description
STATUS_NO_MATCH The data ranges are not compatible.
STATUS_INTERNAL_ERROR There was an unexpected format size mismatch.
STATUS_BUFFER_OVERFLOW The intersect handler returns the required buffer size through the ReportedDataSize member.
STATUS_BUFFER_TOO_SMALL The intersect handler was not provided with a buffer large enough to hold the resulting format. The intersect handler must be called again with the DataBufferSize set to zero to determine the required buffer size.
STATUS_INSUFFICIENT_RESOURCES An internal buffer allocation failed.

Remarks

The AV/C intersect handler is user-defined, based on the function prototype above.

The handler is used in conjunction with the AVC_FUNCTION_GET_PIN_DESCRIPTOR function code. The purpose of the handler is to match identical pin data formats and return them to the caller.

Requirements

Requirement Value
Target Platform Desktop
Header avc.h (include Avc.h)

See also