Compartir a través de

Método IMFASFStreamConfig::GetPayloadExtension (wmcontainer.h)

  • Artículo

Recupera información sobre una extensión de carga existente.

Sintaxis

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

Parámetros

[in] wPayloadExtensionNumber

Índice de extensión de carga. Los índices válidos oscilan entre 0 y uno menor que el número de extensiones obtenidos llamando a IMFASFStreamConfig::GetPayloadExtensionCount.

[out] pguidExtensionSystemID

Recibe un GUID que identifica la extensión de carga. Para obtener una lista de extensiones de carga predefinidas, consulte GUID de extensión de carga de ASF. Las aplicaciones también pueden definir extensiones de carga personalizadas.

[out] pcbExtensionDataSize

Recibe el número de bytes agregados a cada ejemplo de la extensión.

[out] pbExtensionSystemInfo

Puntero a un búfer que recibe información sobre este sistema de extensiones. Esta información es la misma para todos los ejemplos y se almacena en el encabezado de contenido (no en cada ejemplo). Este parámetro puede ser NULL. Para buscar el tamaño necesario del búfer, establezca este parámetro en NULL; el tamaño se devuelve en pcbExtensionSystemInfo.

[in, out] pcbExtensionSystemInfo

En la entrada, especifica el tamaño del búfer al que apunta pbExtensionSystemInfo. En la salida, recibe el tamaño necesario del búfer pbExtensionSystemInfo en bytes.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 Argumento no válido.
MF_E_BUFFERTOOSMALL
 El búfer especificado en pbExtensionSystemInfo es demasiado pequeño.
MF_E_INVALIDINDEX
 El parámetro wPayloadExtensionNumber está fuera del intervalo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wmcontainer.h
Library Mfuuid.lib

Consulte también

IMFASFStreamConfig

IMFASFStreamConfig::AddPayloadExtension

IMFASFStreamConfig::GetPayloadExtensionCount