IMiniportWaveRTOutputStream::GetOutputStreamPresentationPosition メソッド (portcls.h)

ストリーム プレゼンテーション情報を返します。

構文

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

パラメーター

[out] pPresentationPosition

pPresentationPosition は、オーディオ データ ストリーム内の最近のプレゼンテーション位置を表す KSAUDIO_PRESENTATION_POSITION 構造体を返します。 詳細については、「 IMiniportStreamAudioEngineNode::GetStreamPresentationPosition」を参照してください。

戻り値

GetOutputStreamPresentationPosition は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、関数は適切なエラー状態コードを返します。

注釈

OS は、ドライバーからこのプロパティを定期的に取得して、上位レイヤーがビデオやその他のアクティビティをオーディオ ストリームと同期できるようにするために、ドライバーから最近のプレゼンテーション位置情報を取得する場合があります。

KSAUDIO_PRESENTATION_POSITION の u64PositionInBlocks メンバーで返される値は、GetPacketCount によって返されるパケット数と、SetWritePacket に渡されるパケット番号のドライバーの解釈と一致している必要があります。 つまり、パケット 0 の最初のサンプルはブロック 0 です。

これは、GetPacketCount と GetOutputStreamPresentationPosition が同時に呼び出されると、同じサンプルを参照する値を返すという意味ではありません。 GetPacketCount は WaveRT バッファーからハードウェアに転送されたサンプルに関する情報を返し、GetOutputStreamPresentationPosition はシステムの出力で提示されたサンプルに関する情報を返します。 これらは 2 つの異なる情報です。

要件

こちらもご覧ください

IMiniportWaveRTOutputStream