Freigeben über

IMDSPDevice::GetName-Methode (mswmdm.h)

  • Artikel

Die GetName-Methode ruft den Namen des Geräts ab.

Syntax

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parameter

[out] pwszName

Zeiger auf ein Array von 16-Bit-Unicode-Zeichen, das die Gerätenamenzeichenfolge empfängt.

[in] nMaxChars

Maximale Anzahl von Zeichen, die in die Zeichenfolge kopiert werden sollen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Standard-COM-Fehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Der LPWSTR-Zeichenfolgentyp ist eine 16-Bit-Unicode-Zeichenfolge und akzeptiert keine Bytezeichen. Verwenden Sie die MultiByteToWideChar-Funktion, wie in der Microsoft Windows-Dokumentation beschrieben, um eine Zeichenfolge mit Bytegröße (LPCSTR) in eine LPWSTR-Zeichenfolge zu konvertieren.

Gerätenamen dürfen keine nachfolgenden Leerzeichen enthalten.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPDevice-Schnittstelle

IMDSPDevice::GetType