IOCTL_KS_RESET_STATE IOCTL (ks.h)

Eine Anwendung kann IOCTL_KS_RESET_STATE verwenden, um einen Pin in den Zustand zurückzugeben, in dem sie sich zum Zeitpunkt der Beschaffung befand. Die Anwendung übergibt IOCTL_KS_RESET_STATE mit den unten beschriebenen Parametern an die KsSynchronousDeviceControl-Funktion .

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Ein Client stellt einen Puffer bereit, der den Zurücksetzungswert (KSRESET_BEGIN, KSRESET_END) im InBuffer-Parameter enthält.

Eingabepufferlänge

InLength gibt die Größe des Eingabepufferinhalts in Bytes an.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Statusblock

Wenn die Anforderung erfolgreich ist, wird das Statuselement auf STATUS_SUCCESS festgelegt.

Hinweise

Initiieren Sie eine Zurücksetzung für einen Pin, indem Sie IOCTL_KS_RESET_STATE mit dem Wert KSRESET_BEGIN im InBuffer-Parameter von KsSynchronousDeviceControl senden.

Wenn der Zurücksetzungszustand initiiert wird, werden vorhandene Lese- und Schreibanforderungen abgebrochen. Im Zurücksetzungszustand werden alle neuen Lese- oder Schreibanforderungen mit STATUS_DEVICE_NOT_READY abgelehnt.

Um den Zurücksetzungszustand zu beenden, senden Sie IOCTL_KS_RESET_STATE mit dem Wert KSRESET_END.

Beachten Sie, dass der Zurücksetzungszustand nicht abgebrochen wird, indem der Pinzustand geändert wird.

Wenn der Zurücksetzungszustand beendet wird, kann der Pin erneut neue Daten akzeptieren und Daten an andere Verbindungen übergeben.

Anforderungen

Anforderung	Wert
Header	ks.h (einschließlich Ks.h)

Weitere Informationen

AVStrMiniFilterReset

AVStrMiniPinReset

KSFILTER_DISPATCH

KsAcquireResetValue