Metodo IPortWavePciStream::TerminatePacket (portcls.h)

Il TerminatePacket metodo termina il mapping del pacchetto attualmente in corso.

Sintassi

NTSTATUS TerminatePacket();

Valore restituito

TerminatePacket restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

Questo metodo viene usato principalmente per le situazioni di acquisizione in cui i pacchetti di I/O devono terminare in punti specifici del flusso ,ad esempio per la sincronizzazione con fotogrammi video. Il buffer dei dati per un pin di acquisizione in un dispositivo audio è costituito da uno o più pacchetti di I/O. Ogni pacchetto di I/O è la parte del buffer di dati collegato a un particolare IRP di mapping. Per impostazione predefinita, mentre un flusso di acquisizione si trova nello stato KSSTATE_RUN, il contenuto di un pacchetto di I/O diventa disponibile per il client solo quando è stato compilato l'ultimo mapping nel pacchetto. Il TerminatePacket metodo rende immediatamente disponibile un pacchetto parzialmente riempito per il client senza attendere ulteriori dati di acquisizione.

La modifica dello stato di un flusso di acquisizione da KSSTATE_RUN a KSSTATE_STOP termina automaticamente il pacchetto di I/O corrente.

Requisiti