IMDSPDeviceControl::GetDCStatus-Methode (mswmdm.h)
Die GetDCStatus-Methode ruft das Steuerelement status des Geräts ab.
Syntax
HRESULT GetDCStatus(
[out] DWORD *pdwStatus
);
Parameter
[out] pdwStatus
Zeiger auf ein DWORD,das das Steuerelement status des Geräts enthält. Das Steuerelement status Wert enthält mindestens eines der folgenden Flags.
| Flag | Beschreibung |
|---|---|
| WMDM_STATUS_READY | Windows Media-Geräte-Manager und die zugehörigen Unterkomponenten sind bereit. |
| WMDM_STATUS_BUSY | Ein Vorgang wird derzeit ausgeführt. Werten Sie die anderen status Werte aus, um zu bestimmen, 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 ist 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 Status von 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 daten heruntergeladen werden 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 ausgelasteten Code und müssen die GetStatus-Methode der zugeordneten IMDSPDevice-Schnittstelle 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 der status-Werte enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |