IKsPin::KsDecrementPendingIoCount method (ksproxy.h)

The KsDecrementPendingIoCount method decrements the number of input/output (I/O) operations that are in progress on a pin.

Syntax

LONG KsDecrementPendingIoCount();

Return value

Returns an integer from 0 to n, the value that represents the new number of I/O operations that are in progress.

Remarks

The KsDecrementPendingIoCount method is typically called from within an interface handler as described in the following sequence:

  1. The proxy creates an instance of an interface handler (IKsInterfaceHandler) to handle a particular media type.
  2. A client calls the IKsInterfaceHandler::KsSetPin method to inform that interface handler about the pin with which to communicate when passing data.
  3. The client calls the IKsInterfaceHandler::KsProcessMediaSamples method to move samples from or to the assigned pin. KsProcessMediaSamples performs I/O operations and for each I/O operation, calls IKsPin::KsIncrementPendingIoCount to increment the I/O count.
  4. The client calls the IKsInterfaceHandler::KsCompleteIo method to complete an I/O operation. KsCompleteIo calls KsDecrementPendingIoCount to decrement the I/O count.

Requirements

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

See also

IKsInterfaceHandler

IKsInterfaceHandler::KsCompleteIo

IKsInterfaceHandler::KsProcessMediaSamples

IKsInterfaceHandler::KsSetPin

IKsPin::KsIncrementPendingIoCount