Metodo IPortWavePciStream::TerminatePacket (portcls.h)

Il metodo TerminatePacket termina il pacchetto attualmente mappato.

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.

Osservazioni

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 di 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 è nello stato KSSTATE_RUN, il contenuto di un pacchetto di I/O diventa disponibile per il client solo quando è stato riempito l'ultimo mapping nel pacchetto. Il metodo TerminatePacket 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.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	portcls.h (include Portcls.h)
IRQL	<=DISPATCH_LEVEL