IStiDevice::RawWriteCommand-Methode (sti.h)

Die IStiDevice::RawWriteCommand-Methode sendet Befehlsinformationen an ein Standbildgerä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 angegebene Anzahl der zu schreibenden Bytes. Dies ist die Anzahl der Bytes im Puffer, auf die von lpBuffer verwiesen wird.

[in, optional] lpOverlapped

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

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

Die IStiDevice::RawWriteCommand-Methode ruft IStiUSD::RawWriteCommand auf, das von vom Anbieter bereitgestellten Minidrivern exportiert wird. Die Bedeutung von Pufferinhalten ist vom Anbieter definiert.

IStiDevice::RawWriteCommand muss nur aufgerufen werden, wenn Befehle und Daten mit unterschiedlichen Methoden auf ein Gerät geschrieben werden. Für andere Geräte kann IStiDevice::RawWriteData sowohl für Befehle als auch für Daten verwendet werden.

Vor dem Aufrufen von IStiDevice::RawWriteCommand müssen Clients der IStiDevice-COM-SchnittstelleIStillImage::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 vorangestellt sein, gefolgt von einem Aufruf von IStiDevice::UnLockDevice.

Anforderungen