KsStreamPointerAdvance 関数 (ks.h)
KsStreamPointerAdvance 関数は、ストリーム ポインターを次のデータ フレームに進めます。
構文
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
パラメーター
[in] StreamPointer
次に使用可能なデータ フレームを参照するために進むストリーム ポインターを表す KSSTREAM_POINTER 構造体へのポインター。
戻り値
KsStreamPointerAdvance は、成功した進歩を示すSTATUS_SUCCESSを返します。 それ以外の場合はエラー コードを返します。 STATUS_DEVICE_NOT_READYは最も頻繁に返されるエラー コードであり、多くの場合、進んだ後にストリーム ポインターをロックできなかったことを示します。 つまり、streamPointer は、キュー内の最後のフレームを参照します。
備考
StreamPointer が呼び出し時にロックされている場合、AVStream はロックを解除してから続行します。 高度になると、ストリーム ポインターは新しいフレームの元の状態 (ロックまたはロック解除済み) に戻されます。
ロック解除されたストリーム ポインターを進める試みは常に成功し、STATUS_SUCCESSを返します。 ストリーム ポインターはロックされていないため、ストリーム ポインターが実際のデータを参照しているかどうかを判断する方法はありません。 ミニドライバーは、新しく高度なストリーム ポインターがデータ フレームを参照するかどうかを判断するロックを試みる必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | ks.h (Ks.h を含む) |
| ライブラリ | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
関連項目
KsStreamPointerAdvanceOffsets の
KsStreamPointerAdvanceOffsetsAndUnlock の
KsStreamPointerLock を する
KsStreamPointerUnlock の