Compartir a través de

Método IMFASFIndexer::GetIndexStatus (wmcontainer.h)

  • Artículo

Recupera la configuración de índice de un flujo y un tipo de índice especificados.

Sintaxis

HRESULT GetIndexStatus(
  [in]      ASF_INDEX_IDENTIFIER *pIndexIdentifier,
  [out]     BOOL                 *pfIsIndexed,
  [out]     BYTE                 *pbIndexDescriptor,
  [in, out] DWORD                *pcbIndexDescriptor
);

Parámetros

[in] pIndexIdentifier

Puntero a una estructura de ASF_INDEX_IDENTIFIER que contiene el número de secuencia y el tipo de índice para el que se va a obtener el estado.

[out] pfIsIndexed

Variable que recupera un valor booleano que especifica si se ha creado el índice descrito por pIndexIdentifier .

[out] pbIndexDescriptor

Búfer que recibe el descriptor de índice. El descriptor de índice consta de una estructura de ASF_INDEX_DESCRIPTOR , seguida opcionalmente de datos específicos del índice.

[in, out] pcbIndexDescriptor

En la entrada, especifica el tamaño, en bytes, del búfer al que apunta pbIndexDescriptor . El valor puede ser cero si pbIndexDescriptor es NULL. En la salida, recibe el tamaño del descriptor de índice, 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.
MF_E_BUFFERTOOSMALL
 El tamaño del búfer especificado en pcbIndexDescriptor es demasiado pequeño.

Comentarios

Para leer un índice ASF existente, llame a IMFASFIndexer::SetIndexByteStreams antes de llamar a este método.

Si existe un índice para la secuencia y el valor pasado a pcbIndexDescriptor es menor que el tamaño necesario del búfer pbIndexDescriptor , el método devuelve MF_E_BUFFERTOOSMALL. El tamaño del búfer necesario se devuelve en el parámetro pcbIndexDescriptor .

Si no hay ningún índice para la secuencia especificada, el método devuelve FALSE en el parámetro pfIsIndexed .

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

Objeto de índice de ASF

IMFASFIndexer