IOCTL_KS_RESET_STATE control code

An application can use IOCTL_KS_RESET_STATE to return a pin to the state it was in at Acquire-time. The application passes IOCTL_KS_RESET_STATE with the parameters described below to the KsSynchronousDeviceControl function.

Input Parameters

A client provides a buffer that contains the reset value (KSRESET_BEGIN, KSRESET_END) in the InBuffer parameter. InLength specifies size, in bytes, of the input buffer contents.

Output Parameters

None

I/O Status Block

If the request is successful, the Status member is set to STATUS_SUCCESS.

Remarks

Initiate a reset on a pin by sending IOCTL_KS_RESET_STATE with a value of KSRESET_BEGIN in the InBuffer parameter of KsSynchronousDeviceControl.

When the reset state is initiated, existing read and write requests are canceled. While in the reset state, any new read or write requests are rejected with STATUS_DEVICE_NOT_READY.

To terminate the reset state, send IOCTL_KS_RESET_STATE with a value of KSRESET_END.

Note that the reset state is not canceled by changing the pin state.

When the reset state is terminated, the pin can again accept new data and pass data to other connections.

Requirements

Header

Ks.h (include Ks.h)

See also

KsAcquireResetValue
AVStrMiniFilterReset
AVStrMiniPinReset
KSFILTER_DISPATCH

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft