IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator-Methode (mfidl.h)

  • Artikel

Initialisiert die Beispielzuweisung mit Parametern, die für Videoaufnahmeszenarien relevant sind.

Syntax

HRESULT InitializeCaptureSampleAllocator(
  DWORD         cbSampleSize,
  DWORD         cbCaptureMetadataSize,
  DWORD         cbAlignment,
  DWORD         cMinimumSamples,
  IMFAttributes *pAttributes,
  IMFMediaType  *pMediaType
);

Parameter

cbSampleSize

Ein DWORD, das die Stichprobengröße in Bytes angibt. Die tatsächliche Stichprobengröße, die vom Allocator verwendet wird, ist die maximale Größe, die für pMediaType und cbSampleSize erforderlich ist.

cbCaptureMetadataSize

Ein DWORD, das die Größe der Erfassungsmetadaten in Bytes angibt. Gilt nur für Aufrufer, die zusätzliche Metadaten in die erfassten Frames einschließen möchten. Die Metadatengröße sollte die Größe eines KSCAMERA_METADATA_ITEMHEADER zusätzlich zur Größe der Metadatennutzlast selbst enthalten.

cbAlignment

Ein DWORD, das die Pufferausrichtungsgröße in Bytes angibt. Die Standard- und Mindestausrichtungsgröße beträgt 4 KB. Benutzerdefinierte Ausrichtungsgrößen, die kleiner als 4 KB sind, werden als 4 KB behandelt.

cMinimumSamples

Ein DWORD, das die Mindestanzahl von vorab zugeordneten Stichproben angibt. Bei dieser Methode tritt ein Fehler auf, wenn der Zuweisungsator die angegebene Mindestanzahl von Stichproben nicht vorab zuordnen kann.

pAttributes

Optional. Ein IMFAttributes-Speicher mit zusätzlichen Konfigurationsattributen für die Beispielzuweisung. Die unterstützten Attribute sind:

pMediaType

Ein IMFMediaType , der den Medientyp angibt, für den Beispiele zugewiesen werden sollen. Die Beispielzuweisung verwendet diesen Parameter, um die erforderliche Mindestgröße für die Medienbeispiele zu berechnen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDMEDIATYPE Ungültiger Medientyp.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server) Windows Server, Version 2004 (10.0; Build 19041)
Kopfzeile mfidl.h