IMiniportWaveRTOutputStream::GetOutputStreamPresentationPosition-Methode (portcls.h)

Gibt Datenstrompräsentationsinformationen zurück.

Syntax

NTSTATUS GetOutputStreamPresentationPosition(
  [out] KSAUDIO_PRESENTATION_POSITION *pPresentationPosition
);

Parameter

[out] pPresentationPosition

pPresentationPosition gibt eine KSAUDIO_PRESENTATION_POSITION-Struktur zurück, die eine aktuelle Präsentationsposition im Audiodatenstrom darstellt. Weitere Informationen finden Sie unter IMiniportStreamAudioEngineNode::GetStreamPresentationPosition.

Rückgabewert

GetOutputStreamPresentationPosition gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Funktion einen geeigneten Fehler status Code zurück.

Hinweise

Das Betriebssystem kann diese Eigenschaft in regelmäßigen Abständen vom Treiber abrufen, um aktuelle Präsentationspositionsinformationen vom Treiber abzurufen, damit obere Ebenen Video oder andere Aktivitäten mit dem Audiodatenstrom synchronisieren können.

Der wert, der im u64PositionInBlocks-Element von KSAUDIO_PRESENTATION_POSITION zurückgegeben wird, sollte mit der paketanzahl konsistent sein, die von GetPacketCount zurückgegeben wird, und der Interpretation der an SetWritePacket übergebenen Paketnummer durch den Treiber. Anders ausgedrückt: Das erste Beispiel von Paket 0 ist Block 0.

Dies bedeutet nicht, dass GetPacketCount und GetOutputStreamPresentationPosition, wenn sie gleichzeitig aufgerufen werden, Werte zurückgeben würden, die auf dasselbe Beispiel verweisen. GetPacketCount gibt Informationen zu den Beispielen zurück, die vom WaveRT-Puffer an die Hardware übertragen wurden, während GetOutputStreamPresentationPosition Informationen zu Beispielen zurückgibt, die in der Ausgabe des Systems angezeigt werden. Dies sind zwei verschiedene Informationen.

Anforderungen

Weitere Informationen

IMiniportWaveRTOutputStream