Condividi tramite


Metodo IMFASFStreamConfig::GetPayloadExtension (wmcontainer.h)

Recupera informazioni su un'estensione del payload esistente.

Sintassi

HRESULT GetPayloadExtension(
  [in]      WORD  wPayloadExtensionNumber,
  [out]     GUID  *pguidExtensionSystemID,
  [out]     WORD  *pcbExtensionDataSize,
  [out]     BYTE  *pbExtensionSystemInfo,
  [in, out] DWORD *pcbExtensionSystemInfo
);

Parametri

[in] wPayloadExtensionNumber

Indice dell'estensione del payload. Gli indici validi sono compresi tra 0 e uno inferiore al numero di estensioni ottenute chiamando FMASFStreamConfig::GetPayloadExtensionCount.

[out] pguidExtensionSystemID

Riceve un GUID che identifica l'estensione del payload. Per un elenco di estensioni del payload predefinite, vedere GUID dell'estensione del payload ASF. Le applicazioni possono anche definire estensioni del payload personalizzate.

[out] pcbExtensionDataSize

Riceve il numero di byte aggiunti a ogni esempio per l'estensione.

[out] pbExtensionSystemInfo

Puntatore a un buffer che riceve informazioni su questo sistema di estensione. Queste informazioni sono uguali per tutti gli esempi e vengono archiviate nell'intestazione del contenuto (non in ogni esempio). Questo parametro può essere NULL. Per trovare le dimensioni necessarie del buffer, impostare questo parametro su NULL; la dimensione viene restituita in pcbExtensionSystemInfo.

[in, out] pcbExtensionSystemInfo

In input specifica le dimensioni del buffer a cui punta pbExtensionSystemInfo. Nell'output riceve le dimensioni necessarie del buffer pbExtensionSystemInfo in byte.

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.
E_INVALIDARG
Argomento non valido.
MF_E_BUFFERTOOSMALL
Il buffer specificato in pbExtensionSystemInfo è troppo piccolo.
MF_E_INVALIDINDEX
Il parametro wPayloadExtensionNumber non è compreso nell'intervallo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wmcontainer.h
Libreria Mfuuid.lib

Vedi anche

FMASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount