MediaStreamSourceSampleRequest.Sample Eigenschaft

Definition

Namespace:

Windows.Media.Core

Legt das mediaStreamSample fest, das von mediaStreamSource angefordert wird. Anwendungen stellen mediaStreamSample an MediaStreamSource bereit, indem sie dieser Eigenschaft einen Wert zuweisen.

public:
 property MediaStreamSample ^ Sample { MediaStreamSample ^ get(); void set(MediaStreamSample ^ value); };

MediaStreamSample Sample();

void Sample(MediaStreamSample value);

public MediaStreamSample Sample { get; set; }

var mediaStreamSample = mediaStreamSourceSampleRequest.sample;
mediaStreamSourceSampleRequest.sample = mediaStreamSample;

Public Property Sample As MediaStreamSample

Eigenschaftswert

MediaStreamSample

Das Beispiel, das an die MediaStreamSource übermittelt wird, wenn diese Eigenschaft festgelegt wird. Der Standardwert lautet null.

Hinweise

Der Anfangswert dieser Eigenschaft ist NULL.

Die Anwendung sollte ein MediaStreamSample zuordnen und an mediaStreamSource übermitteln, indem sie dieser Eigenschaft mediaStreamSample zuweisen.

Wenn keine MediaStreamSamples mehr an den von der StreamDescriptor-Eigenschaft identifizierten Stream übermittelt werden können, da das Ende des Datenstroms erreicht wurde, sollte die Anwendung die Sample-Eigenschaft auf NULL festlegen.

Wenn die Anwendung einen asynchronen Vorgang ausführen muss, um mediaStreamSample abzurufen, sollte sie die GetDeferral-Methode aufrufen, um anzugeben, dass die Zuweisung der Sample-Eigenschaft verzögert wurde.

Wenn ein MediaStreamSample derzeit nicht verfügbar ist, z. B. weil es noch nicht von einem Server heruntergeladen wurde, sollte die Anwendung GetDeferral aufrufen und auch ReportSampleProgress on aufrufen, wenn die erforderlichen Daten heruntergeladen werden.

Das empfohlene Intervall zwischen jedem Aufruf von ReportSampleProgress beträgt 500 Millisekunden.