Compartir a través de


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)