Método IAMExtTransport::GetStatus (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetStatus método devuelve información sobre el estado del transporte.

Sintaxis

HRESULT GetStatus(
  [in]      long StatusItem,
  [in, out] long *pValue
);

Parámetros

[in] StatusItem

Especifica la información de estado que se va a recuperar. Vea Comentarios para obtener más información.

[in, out] pValue

Puntero a variable que especifica o recibe un entero largo , cuyo significado depende del valor de StatusItem. Vea Comentarios para obtener más información.

Valor devuelto

Cuando este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El parámetro StatusItem es una marca que especifica qué información de estado se va a recuperar. El método devuelve en la información del parámetro pValue . No todos los dispositivos admiten todas las marcas de estado. Se definen las marcas siguientes:

• ED_MODE: devuelve el modo de transporte actual, como pausa o reproducción. Consulte IAMExtTransport::p ut_Mode para obtener una lista de constantes que definen los modos de transporte. Como alternativa, puede establecer StatusItem igual a una de estas constantes, y pValue recibirá el valor OATRUE si el transporte está actualmente en ese modo o OAFALSE en caso contrario.
• ED_MEDIA_TYPE: indica el formato del medio para este transporte. Devuelve una de las constantes siguientes.

  Constante	Descripción
  ED_MEDIA_VHS	VHS
  ED_MEDIA_SVHS	S-VHS
  ED_MEDIA_HI8	Hola 8
  ED_MEDIA_UMATIC	Umatic
  ED_MEDIA_DVC	Cinta DV (DVC)
  ED_MEDIA_1_INCH	Cinta de 1 pulgada
  ED_MEDIA_D1	Formato D1
  ED_MEDIA_D2	Formato D2
  ED_MEDIA_D3	Formato D3
  ED_MEDIA_D5	Formato D5
  ED_MEDIA_DBETA	Digital Betacam
  ED_MEDIA_BETA	Betacam
  ED_MEDIA_8MM	8 milímetros
  ED_MEDIA_DDR	Grabadora de disco digital
  ED_MEDIA_SX	Betacam SX
  ED_MEDIA_OTHER	Otros
  ED_MEDIA_CLV	CLV (velocidad lineal constante o "reproducción estándar") laserdisc
  ED_MEDIA_CAV	CAV (constante Angular velocidad o "reproducción extendida") laserdisc

   
• ED_LINK_MODE: devuelve OATRUE si los controles del transporte están vinculados a los métodos Run, Stop y Pause del grafo de filtro y OAFALSE en caso contrario. Consulte IAMExtTransport::p ut_Mode para obtener más información.
• ED_MEDIA_PRESENT: devuelve OATRUE si el medio del transporte está presente o OAFALSE en caso contrario.
• ED_MEDIA_LENGTH: devuelve la longitud del medio, en unidades del formato de hora actual (vea IAMExtTransport::SetTransportBasicParameters).
• ED_MEDIA_TRACK_COUNT: devuelve el recuento de pistas.
• ED_MEDIA_TRACK_LENGTH: devuelve la longitud de la pista, en unidades del formato de hora actual.
• ED_MEDIA_SIDE: indica qué lado del medio está activo.

En Windows XP Service Pack 2 y versiones posteriores, se definen los siguientes modos de reproducción adicionales para ED_MODE.

Constante	Descripción
ED_MODE_PLAY_SLOW_FWD_X	Reproduzca lentamente sin especificar. (Juego de avance lento a velocidad específica del proveedor).
ED_MODE_PLAY_FAST_FWD_X	Juega rápido hacia adelante sin especificar. (Juego rápido hacia delante a velocidad específica del proveedor).
ED_MODE_PLAY_SLOW_REV_X	Reproducir reverso lento sin especificar. (Juego inverso lento a velocidad específica del proveedor).
ED_MODE_PLAY_FAST_REV_X	Reproducir inverso rápido sin especificar. (Juego rápido inverso a velocidad específica del proveedor).
ED_MODE_STOP_START	El transporte se detiene al principio de la cinta (u otro medio de transporte).
ED_MODE_STOP_END	El transporte se detiene al final de la cinta (u otro medio de transporte).
ED_MODE_STOP_EMERGENCY	El transporte se ha detenido debido a condiciones inesperadas o para evitar posibles daños en el transporte.

 

Para usar estas constantes, incluya el archivo de encabezado Xprtdefs.h del Windows SDK.

Implementación de DV

MSDV admite las siguientes marcas de estado:

• ED_MODE: vea los comentarios anteriores.
• ED_MEDIA_TYPE: devuelve uno de los valores siguientes.

  Constante	Descripción
  ED_MEDIA_VHS	Cinta VHS.
  ED_MEDIA_DVC	Cinta DV.
  ED_MEDIA_UNKNOWN	Tipo desconocido.
  ED_MEDIA_NOT_PRESENT	El transporte está vacío.

   
• ED_DEV_REMOVED_HEVENT_GET. Devuelve un identificador a un evento. El controlador indica el evento si el dispositivo se quita físicamente del sistema.
• ED_DEV_REMOVED_HEVENT_RELEASE. Libera el identificador de eventos obtenido a través de la marca ED_DEV_REMOVED_HEVENT_GET. Especifique la dirección del identificador en el parámetro pValue.
• ED_MODE_CHANGE_NOTIFY. Devuelve el estado del dispositivo en pValue. Si el método devuelve E_PENDING, hay un cambio de estado pendiente. Puede usar la marca ED_NOTIFY_HEVENT_GET para obtener la notificación cuando se complete el cambio de estado.
• ED_NOTIFY_HEVENT_GET. Devuelve un identificador a un evento. El controlador indica el evento cuando el dispositivo completa un cambio de modo.
• ED_NOTIFY_HEVENT_RELEASE. Libera el identificador de eventos obtenido a través de la marca ED_NOTIFY_HEVENT_GET. Especifique la dirección del identificador en el parámetro pValue.

Implementación de mpeg videocámara

MSTape admite un formato multimedia adicional para la marca ED_MEDIA_TYPE.

Constante	Descripción
ED_MEDIA_NEO	Mini cinta digital para el flujo de transporte MPEG-2 (D-VHS).

 

Algunas de estas marcas se definen en el archivo de encabezado Xptrdefs.h.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IAMExtTransport (interfaz)