IStiDevice::D iagnostische Methode (sti.h)

Die IStiDevice::D iagnostische-Methode führt Diagnosetests auf einem Stillbildgerät aus.

Syntax

HRESULT Diagnostic(
  [in, out] LPSTI_DIAG pBuffer
);

Parameter

[in, out] pBuffer

Vom Aufrufer bereitgestellter Zeiger auf eine STI_DIAG Struktur, die den Typ der auszuführenden Tests angibt. Bei Rückgabe enthält die Struktur Statusinformationen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Die IStiDevice::D iagnostic-Methode ruft IStiUSD::D iagnostischeauf, die von einem Hersteller bereitgestellten Minidriver exportiert wird. Die Systemsteuerung für Scanner und Kameras ruft IStiDevice::D iagnostische auf, wenn ein Benutzer die Schaltfläche "Testen" drückt.

Vor dem Aufrufen IStiDevice::D iagnosticmüssen Clients der IStiDevice- COM-Schnittstelle IStillImage::CreateDevice aufrufen, um einen IStiDevice- Schnittstellenzeiger abzurufen, der Zugriff auf ein angegebenes Gerät ermöglicht.

Einem Aufruf von IStiDevice::D iagnostic muss ein Aufruf von IStiDevice::LockDevice und gefolgt von einem Aufruf von IStiDevice::UnLockDevicevorangestellt werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	sti.h (einschließlich Sti.h)