IKsPin::KsIncrementPendingIoCount method (ksproxy.h)

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

Syntax

LONG KsIncrementPendingIoCount();

Return value

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

Remarks

The KsIncrementPendingIoCount 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 KsIncrementPendingIoCount to increment the I/O count.
  4. The client calls the IKsInterfaceHandler::KsCompleteIo method to complete an I/O operation. KsCompleteIo calls IKsPin::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::KsDecrementPendingIoCount