IPortWavePciStream::TerminatePacket メソッド (portcls.h)

メソッドは TerminatePacket 、現在マップされているパケットを終了します。

構文

NTSTATUS TerminatePacket();

戻り値

TerminatePacket は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。

注釈

この方法は、主に、ストリーム内の特定のポイントで I/O パケットを終了する必要があるキャプチャ状況 (ビデオ フレームと同期する場合など) に使用されます。 オーディオ デバイス上のキャプチャ ピンのデータ バッファーは、1 つ以上の I/O パケットで構成されます。 各 I/O パケットは、特定のマッピング IRP に接続されているデータ バッファーの部分です。 既定では、キャプチャ ストリームはKSSTATE_RUN状態ですが、I/O パケットの内容は、パケットの最後のマッピングが入力されている場合にのみクライアントで使用できるようになります。 メソッドは TerminatePacket 、追加のキャプチャ データを待たずに、部分的に塗りつぶされたパケットをクライアントですぐに使用できるようにします。

キャプチャ ストリームの状態を KSSTATE_RUN から KSSTATE_STOP に変更すると、現在の I/O パケットが自動的に終了します。

要件