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 はストリーム ポインターがロックされたときにマッピングを生成します。
「Stream ポインター」も参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| Library | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |