MÉTHODE IMFVideoCaptureSampleAllocator ::InitializeCaptureSampleAllocator (mfidl.h)

Initialise l’exemple d’allocateur avec les paramètres pertinents pour les scénarios de capture vidéo.

Syntaxe

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

Paramètres

cbSampleSize

DWORD spécifiant la taille de l’échantillon en octets. La taille d’échantillon réelle utilisée par l’allocateur est la taille maximale requise par pMediaType et cbSampleSize.

cbCaptureMetadataSize

DWORD spécifiant la taille des métadonnées de capture en octets. S’applique uniquement aux appelants qui souhaitent inclure des métadonnées supplémentaires avec les trames capturées. La taille des métadonnées doit inclure la taille d’un KSCAMERA_METADATA_ITEMHEADER en plus de la taille de la charge utile de métadonnées elle-même.

cbAlignment

DWORD spécifiant la taille d’alignement de la mémoire tampon en octets. La taille d’alignement par défaut et minimale est de 4 Ko. Les tailles d’alignement personnalisées inférieures à 4 Ko sont traitées comme 4 Ko.

cMinimumSamples

DWORD spécifiant le nombre minimal d’échantillons pré-alloués. Cette méthode échoue si l’allocateur ne peut pas préallouer le nombre minimal d’échantillons spécifié.

pAttributes

facultatif. Un magasin IMFAttributes avec des attributs de configuration supplémentaires pour l’exemple d’allocateur. Les attributs pris en charge sont les suivants :

• MF_SA_BUFFERS_PER_SAMPLE
• MF_SA_D3D11_BINDFLAGS
• MF_SA_D3D11_USAGE
• MF_SA_D3D11_SHARED
• MF_SA_D3D11_SHARED_WITHOUT_MUTEX

pMediaType

ImfMediaType spécifiant le type de média pour lequel les exemples seront l’allocateur. L’exemple d’allocateur utilise ce paramètre pour calculer la taille minimale requise pour les exemples de média.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Configuration requise