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

Artículo
03/13/2024

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