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

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