IPortWavePciStream::TerminatePacket-Methode (portcls.h)

Die TerminatePacket -Methode beendet das paket, das derzeit zugeordnet wird.

Syntax

NTSTATUS TerminatePacket();

Rückgabewert

TerminatePacket gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Diese Methode wird hauptsächlich für Erfassungssituationen verwendet, in denen E/A-Pakete an bestimmten Punkten im Stream enden müssen (z. B. für die Synchronisierung mit Videoframes). Der Datenpuffer für einen Erfassungspin auf einem Audiogerät besteht aus einem oder mehreren E/A-Paketen. Jedes E/A-Paket ist der Teil des Datenpuffers, der an eine bestimmte Zuordnungs-IRP angefügt ist. Während sich ein Erfassungsdatenstrom im KSSTATE_RUN Zustand befindet, steht der Inhalt eines E/A-Pakets dem Client erst zur Verfügung, wenn die letzte Zuordnung im Paket ausgefüllt wurde. Die TerminatePacket -Methode stellt dem Client ein teilweise gefülltes Paket sofort zur Verfügung, ohne auf zusätzliche Erfassungsdaten zu warten.

Wenn Sie den Status eines Erfassungsdatenstroms von KSSTATE_RUN in KSSTATE_STOP ändern, wird das aktuelle E/A-Paket automatisch beendet.

Anforderungen