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.
| 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 |