IStiDeviceControl::GetMyDevicePortName-Methode (stiusd.h)

  • Artikel

Mit der IStiDeviceControl::GetMyDevicePortName-Methode kann ein Benutzermodus-Standbildminidriver den Portnamen eines Geräts abrufen.

Syntax

HRESULT GetMyDevicePortName(
  LPWSTR lpszDevicePath,
  DWORD  cwDevicePathSize
);

Parameter

lpszDevicePath

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um den Portnamen des Geräts zu empfangen.

cwDevicePathSize

Vom Aufrufer angegebene Anzahl von Zeichen (vom Typ TCHAR) im Puffer, auf den von lpszDevicePath verwiesen wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Der Pfadname, den ein Standbildminidriver durch Aufrufen von IStiDeviceControl::GetMyDevicePortName empfängt, kann als Eingabeargument für CreateFile verwendet werden (in der Microsoft Windows SDK-Dokumentation beschrieben).

Ein Standbildminidriver empfängt einen IStiDeviceControl-Schnittstellenzeiger als Eingabeargument für seine IStiUSD::Initialize-Methode .

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile stiusd.h (einschließlich Stiusd.h)