IOCTL_KS_RESET_STATE IOCTL (ks.h)

Una aplicación puede usar IOCTL_KS_RESET_STATE para devolver un pin al estado en el que estaba en El momento de la adquisición. La aplicación pasa IOCTL_KS_RESET_STATE con los parámetros descritos a continuación a la función KsSynchronousDeviceControl .

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Un cliente proporciona un búfer que contiene el valor de restablecimiento (KSRESET_BEGIN, KSRESET_END) en el parámetro InBuffer .

Longitud del búfer de entrada

InLength especifica el tamaño, en bytes, del contenido del búfer de entrada.

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Bloque de estado

Si la solicitud se realiza correctamente, el miembro Status se establece en STATUS_SUCCESS.

Comentarios

Inicie un restablecimiento en un pin enviando IOCTL_KS_RESET_STATE con un valor de KSRESET_BEGIN en el parámetro InBuffer de KsSynchronousDeviceControl.

Cuando se inicia el estado de restablecimiento, se cancelan las solicitudes de lectura y escritura existentes. Mientras se encuentra en el estado de restablecimiento, las solicitudes de lectura o escritura nuevas se rechazan con STATUS_DEVICE_NOT_READY.

Para finalizar el estado de restablecimiento, envíe IOCTL_KS_RESET_STATE con un valor de KSRESET_END.

Tenga en cuenta que el estado de restablecimiento no se cancela cambiando el estado de anclaje.

Cuando finaliza el estado de restablecimiento, el pin puede volver a aceptar nuevos datos y pasar datos a otras conexiones.

Requisitos

Requisito	Valor
Header	ks.h (incluya Ks.h)

Consulte también

AVStrMiniFilterReset

AVStrMiniPinReset

KSFILTER_DISPATCH

KsAcquireResetValue