IAMExtTransport::GetStatus-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die GetStatus -Methode gibt Informationen zum status des Transports zurück.

Syntax

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

Parameter

[in] StatusItem

Gibt die abzurufenden status Informationen an. Weitere Informationen finden Sie unter Hinweise.

[in, out] pValue

Zeiger auf eine Variable, die eine lange ganze Zahl angibt oder empfängt, deren Bedeutung vom Wert von StatusItem abhängt. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Der StatusItem-Parameter ist ein Flag, das angibt, welche status Informationen abgerufen werden sollen. Die -Methode gibt in den Informationen im pValue-Parameter zurück. Nicht jedes Gerät unterstützt jedes status-Flag. Die folgenden Flags sind definiert:

  • ED_MODE: Gibt den aktuellen Transportmodus zurück, z. B. Anhalten oder Wiedergeben. Eine Liste der Konstanten, die die Transportmodi definieren, finden Sie unter IAMExtTransport::p ut_Mode . Alternativ können Sie StatusItem auf eine dieser Konstanten festlegen, und pValue erhält den Wert OATRUE, wenn sich der Transport derzeit in diesem Modus befindet, oder andernfalls OAFALSE.
  • ED_MEDIA_TYPE: Gibt das Format der Medien für diesen Transport an. Gibt eine der folgenden Konstanten zurück.
    Dauerhaft BESCHREIBUNG
    ED_MEDIA_VHS VHS
    ED_MEDIA_SVHS S-VHS
    ED_MEDIA_HI8 Hi-8
    ED_MEDIA_UMATIC Umatic
    ED_MEDIA_DVC DV-Band (DVC)
    ED_MEDIA_1_INCH 1-Zoll-Band
    ED_MEDIA_D1 D1-Format
    ED_MEDIA_D2 D2-Format
    ED_MEDIA_D3 D3-Format
    ED_MEDIA_D5 D5-Format
    ED_MEDIA_DBETA Digitale Betacam
    ED_MEDIA_BETA Betacam
    ED_MEDIA_8MM 8 Millimeter
    ED_MEDIA_DDR Digital Disk Recorder
    ED_MEDIA_SX Betacam SX
    ED_MEDIA_OTHER Sonstiges
    ED_MEDIA_CLV CLV-Laserdisc (Constant Linear Velocity, "Standardplay")
    ED_MEDIA_CAV CAV -Laserdisc (Constant Angular Velocity oder "extended play")
     
  • ED_LINK_MODE: Gibt OATRUE zurück, wenn die Steuerelemente des Transports mit den Methoden Run, Stop und Pause des Filterdiagramms und andernfalls mit OAFALSE verknüpft sind. Weitere Informationen finden Sie unter IAMExtTransport::p ut_Mode .
  • ED_MEDIA_PRESENT: Gibt OATRUE zurück, wenn das Medien des Transports vorhanden ist, andernfalls OAFALSE.
  • ED_MEDIA_LENGTH: Gibt die Länge der Medien in Einheiten des aktuellen Zeitformats zurück (siehe IAMExtTransport::SetTransportBasicParameters).
  • ED_MEDIA_TRACK_COUNT: Gibt die Trackanzahl zurück.
  • ED_MEDIA_TRACK_LENGTH: Gibt die Länge der Spur in Einheiten des aktuellen Zeitformats zurück.
  • ED_MEDIA_SIDE: Gibt an, welche Seite des Mediums aktiv ist.
In Windows XP Service Pack 2 und höher sind die folgenden zusätzlichen Wiedergabemodi für ED_MODE definiert.
Dauerhaft BESCHREIBUNG
ED_MODE_PLAY_SLOW_FWD_X Spielen Sie nicht angegebene Langsame Vorwärts. (Langsames Vorwärtsspiel mit anbieterspezifischer Geschwindigkeit.)
ED_MODE_PLAY_FAST_FWD_X Spielen Sie nicht angegebene Schnelleinlauf. (Schnelles Vorwärtsspiel mit herstellerspezifischer Geschwindigkeit.)
ED_MODE_PLAY_SLOW_REV_X Spielen Sie nicht angegebene langsame Umgekehrte. (Langsames Umgekehrtes Spiel mit herstellerspezifischer Geschwindigkeit.)
ED_MODE_PLAY_FAST_REV_X Nicht angegebene schnelle Umgekehrte Wiedergabe. (Schnelle Umgekehrte Wiedergabe mit herstellerspezifischer Geschwindigkeit.)
ED_MODE_STOP_START Der Transport wird am Anfang des Bandes (oder eines anderen Transportmediums) beendet.
ED_MODE_STOP_END Der Transport wird am Ende des Bandes (oder eines anderen Transportmediums) beendet.
ED_MODE_STOP_EMERGENCY Der Transport wurde aufgrund unerwarteter Bedingungen oder um mögliche Schäden am Transport zu vermeiden, angehalten.
 

Um diese Konstanten zu verwenden, schließen Sie die Headerdatei Xprtdefs.h aus dem Windows SDK ein.

DV-Implementierung

MSDV unterstützt die folgenden status-Flags:

  • ED_MODE: Siehe vorherige Hinweise.
  • ED_MEDIA_TYPE: Gibt einen der folgenden Werte zurück.
    Dauerhaft BESCHREIBUNG
    ED_MEDIA_VHS VHS-Band.
    ED_MEDIA_DVC DV-Band.
    ED_MEDIA_UNKNOWN Unbekannter Typ.
    ED_MEDIA_NOT_PRESENT Der Transport ist leer.
     
  • ED_DEV_REMOVED_HEVENT_GET. Gibt ein Handle für ein Ereignis zurück. Der Treiber signalisiert das Ereignis, wenn das Gerät physisch aus dem System entfernt wird.
  • ED_DEV_REMOVED_HEVENT_RELEASE. Gibt das Ereignishandle frei, das über das flag ED_DEV_REMOVED_HEVENT_GET abgerufen wurde. Geben Sie die Adresse des Handles im pValue-Parameter an.
  • ED_MODE_CHANGE_NOTIFY. Gibt den Gerätestatus in pValue zurück. Wenn die Methode E_PENDING zurückgibt, steht eine Zustandsänderung aus. Sie können das flag ED_NOTIFY_HEVENT_GET verwenden, um eine Benachrichtigung zu erhalten, wenn die Statusänderung abgeschlossen ist.
  • ED_NOTIFY_HEVENT_GET. Gibt ein Handle für ein Ereignis zurück. Der Treiber signalisiert das Ereignis, wenn das Gerät eine Modusänderung abgeschlossen hat.
  • ED_NOTIFY_HEVENT_RELEASE. Gibt das Über das ED_NOTIFY_HEVENT_GET-Flag abgerufene Ereignishandle frei. Geben Sie die Adresse des Handles im pValue-Parameter an.

MPEG-Camcorder-Implementierung

MSTape unterstützt ein zusätzliches Medienformat für das flag ED_MEDIA_TYPE.

Dauerhaft BESCHREIBUNG
ED_MEDIA_NEO Mini-Digitalband für MPEG-2-Transportstream (D-VHS).
 

Einige dieser Flags sind in der Headerdatei Xptrdefs.h definiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMExtTransport-Schnittstelle