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.

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.

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

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IAMExtTransport-Schnittstelle