IStiDevice::RawWriteCommand-Methode (sti.h)

Artikel
02/07/2025

Die IStiDevice::RawWriteCommand Methode sendet Befehlsinformationen an ein stilles Bildgerät.

Syntax

HRESULT RawWriteCommand(
  [in]           LPVOID       lpBuffer,
                 DWORD        nNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parameter

[in] lpBuffer

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der Daten enthält, die an das Gerät gesendet werden sollen.

nNumberOfBytes

Vom Aufrufer bereitgestellte Anzahl von Bytes, die geschrieben werden sollen. Dies ist die Anzahl der Bytes im Puffer, auf die durch lpBufferverwiesen wird.

[in, optional] lpOverlapped

Optionaler, vom Aufrufer bereitgestellter Zeiger auf eine ÜBERLAPPENDE Struktur (in der Microsoft Windows SDK-Dokumentation beschrieben).

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::RawWriteCommand-Methode ruft IStiUSD::RawWriteCommandauf, das von einem Hersteller bereitgestellte Minidriver exportiert wird. Die Bedeutung von Pufferinhalten ist vom Anbieter definiert.

Es ist nur erforderlich, IStiDevice::RawWriteCommand aufzurufen, wenn Befehle und Daten über verschiedene Methoden auf ein Gerät geschrieben werden. Für andere Geräte können IStiDevice::RawWriteData- sowohl für Befehle als auch für Daten verwendet werden.

Vor dem Aufrufen IStiDevice::RawWriteCommandmü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::RawWriteCommand- muss ein Aufruf von IStiDevice::LockDevice und gefolgt von einem Aufruf von IStiDevice::UnLockDevicevorausgehen.

Anforderungen

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

Freigeben über