Condividi tramite

Metodo IMFVideoCaptureSampleAllocator::InitializeCaptureSampleAllocator (mfidl.h)

  • Articolo

Inizializza l'allocatore di esempio con parametri rilevanti per gli scenari di acquisizione video.

Sintassi

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

Parametri

cbSampleSize

DWORD che specifica le dimensioni di esempio in byte. Le dimensioni effettive di esempio usate dall'allocatore sono il massimo delle dimensioni richieste da pMediaType e cbSampleSize.

cbCaptureMetadataSize

DWORD che specifica le dimensioni dei metadati di acquisizione in byte. Si applica solo ai chiamanti che vogliono includere metadati aggiuntivi con i frame acquisiti. Le dimensioni dei metadati devono includere le dimensioni di un KSCAMERA_METADATA_ITEMHEADER oltre alle dimensioni del payload dei metadati stesso.

cbAlignment

DWORD che specifica le dimensioni di allineamento del buffer in byte. Le dimensioni predefinite e minime di allineamento sono 4 KB. Le dimensioni di allineamento personalizzate inferiori a 4 KB verranno considerate come 4 KB.

cMinimumSamples

DWORD che specifica il numero minimo di campioni pre-allocati. Questo metodo avrà esito negativo se l'allocatore non può allocare il numero minimo di campioni specificato.

pAttributes

facoltativo. Un archivio FMIAttributes con attributi di configurazione aggiuntivi per l'allocatore di esempio. Gli attributi supportati sono:

pMediaType

FmiMediaType specificando il tipo di supporto per cui gli esempi saranno allocatori. L'allocatore di esempio usa questo parametro per calcolare le dimensioni minime necessarie per gli esempi multimediali.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK Il metodo è riuscito.
MF_E_INVALIDMEDIATYPE Tipo di supporto non valido.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 2004 (10.0; Build 19041)
Server minimo supportato Windows Server, versione 2004 (10.0; Build 19041)
Intestazione mfidl.h