IWMDMDeviceControl::GetStatus-Methode (mswmdm.h)
Die GetStatus-Methode ruft das Steuerelement status des Geräts ab.
Syntax
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parameter
[out] pdwStatus
Zeiger auf ein DWORD, das das Steuerelement status des Geräts angibt. Das Steuerelement status Wert gibt mindestens eins der folgenden Flags an.
| Flag | Beschreibung |
|---|---|
| WMDM_STATUS_READY | Windows Media Geräte-Manager und ihre Unterkomponenten befinden sich in einem bereiten Zustand. |
| WMDM_STATUS_BUSY | Derzeit wird ein Vorgang ausgeführt. Werten Sie die anderen status Werte aus, um zu ermitteln, um welchen Vorgang es sich handelt. |
| WMDM_STATUS_DEVICECONTROL_PLAYING | Das Gerät wird derzeit wiedergegeben. |
| WMDM_STATUS_DEVICECONTROL_RECORDING | Das Gerät zeichnet derzeit auf. |
| WMDM_STATUS_DEVICECONTROL_PAUSED | Das Gerät wird derzeit angehalten. |
| WMDM_STATUS_DEVICECONTROL_REMOTE | Der Wiedergabe- oder Aufzeichnungsvorgang des Geräts wird von der Anwendung remote gesteuert. |
| WMDM_STATUS_DEVICECONTROL_STREAM | Die Wiedergabe- oder Aufzeichnungsmethode ist das Streamen von Daten zum oder vom Mediengerät. |
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der pdwStatus-Parameter ist ein ungültiger oder NULL-Zeiger . |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Dieser Aufruf gibt status Werte zurück, die für die Gerätesteuerungsvorgänge dieser Schnittstelle spezifisch sind. Die Steuerung status kann Informationen über den Zustand der steuerungsbezogenen Aktivitäten des Geräts bereitstellen, z. B. Wiedergabe, Aufzeichnung usw. Es kann jedoch keine Informationen über die globale status des Geräts bereitstellen, z. B. ob das Gerät Daten herunter lädt oder aus einem anderen Grund darauf zugegriffen wird. Wenn das Gerät aus einem anderen Grund als der Gerätesteuerung ausgelastet ist, erhalten Sie einen gebuchten Code und müssen die IWMDMDeviceControl::GetStatus-Methode aufrufen, um ausführlichere Informationen zu erhalten.
Sie dürfen nicht versuchen, die Methoden Play, Record, Pause, Resume oder Stop dieser Schnittstelle aufzurufen, wenn der status Wert WMDM_STATUS_BUSY zurückgegeben wird und der status-Wert keine anderen Werte aus der Tabelle mit status-Werten enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |