IStiDevice::RawReadData-Methode (sti.h)
Die IStiDevice::RawReadData-Methode liest Daten von einem Standbildgerät.
Syntax
HRESULT RawReadData(
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwNumberOfBytes,
[in, optional] LPOVERLAPPED lpOverlapped
);
Parameter
[in, out] lpBuffer
Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um vom Gerät gelesene Daten zu empfangen.
[in, out] lpdwNumberOfBytes
Vom Aufrufer bereitgestellter Zeiger auf ein DWORD. Der Aufrufer muss das DWORD mit der Anzahl der Bytes im Puffer laden, auf die von lpBuffer verwiesen wird. Bei der Rückgabe enthält er die Anzahl der tatsächlich gelesenen Bytes.
[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::RawReadData-Methode ruft IStiUSD::RawReadData auf, das von vom Hersteller bereitgestellten Minidrivern exportiert wird.
Vor dem Aufrufen von IStiDevice::RawReadData 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::RawReadData muss ein Aufruf von IStiDevice::LockDevice vorangestellt sein, gefolgt von einem Aufruf von IStiDevice::UnLockDevice.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | sti.h (einschließlich Sti.h) |