KsStreamPointerLock 関数 (ks.h)

KsStreamPointerLock 関数は、指定されたストリーム ポインターのロックを試みます。

構文

KSDDKAPI NTSTATUS KsStreamPointerLock(
  [in] PKSSTREAM_POINTER StreamPointer
);

パラメーター

[in] StreamPointer

ロックを試みるストリーム ポインターを表す KSSTREAM_POINTER 構造体へのポインター。

戻り値

KsStreamPointerLock は、ストリーム ポインターがロックされていることを示すSTATUS_SUCCESSまたは適切なエラー コードを返します。 STATUS_DEVICE_NOT_READYは、フレームをロックできなかったことを示す通常のエラー コードです。 このエラー コードは、StreamPointer 指していたフレームが取り消されたことを意味する場合がよく発生します。

備考

ロックされたストリーム ポインターは、ストリーム ポインターに関連付けられたデータ フレームがあり、ロックが維持されている限り、このフレームが取り消されないことを保証します。 ミニドライバーは、ストリーム ポインターがポイントするデータへのアクセスを試みる前に、ストリーム ポインターをロックする必要があります。

ストリーム ポインターが参照するピンで、KSPIN_FLAG_GENERATE_MAPPINGSを使用して DMA 散布図/収集マッピングを生成する必要があると指定されている場合、AVStream はストリーム ポインターがロックされたときにマッピングを生成します。

ストリーム ポインター も参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム の	万国
ヘッダー	ks.h (Ks.h を含む)
ライブラリ	Ks.lib
IRQL	<=DISPATCH_LEVEL

関連項目

KsStreamPointerUnlock の