IKsPinEx::KsNotifyError method (ksproxy.h)

The KsNotifyError method notifies the filter graph of an error to give the filter graph an opportunity to halt.

Syntax

void KsNotifyError(
  [in] IMediaSample *Sample,
  [in] HRESULT      hr
);

Parameters

[in] Sample

Pointer to the IMediaSample interface for the associated media sample.

[in] hr

Error value for notification. If ERROR_OPERATION_ABORTED (that is, the I/O was purposefully canceled), the filter graph is not notified.

Return value

None

Remarks

The KsNotifyError method notifies the filter graph of the specific error using the EC_ERRORABORT event, which specifies that the error forced the termination of an I/O operation.

For more information about IMediaSample, see the Microsoft Windows SDK documentation.

Requirements

Requirement	Value
Target Platform	Desktop
Header	ksproxy.h (include Ksproxy.h)

See also

IKsPinEx