IStiDevice::RawReadData-Methode (sti.h)
Die IStiDevice::RawReadData-Methode liest Daten von einem Stillbildgerät aus.
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 durch lpBuffer-verwiesen wird. Bei der Rückgabe enthält sie die Anzahl der tatsächlich gelesenen Bytes.
[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::RawReadData-Methode ruft IStiUSD::RawReadDataauf, die von einem Hersteller bereitgestellte Minidriver exportiert wird.
Vor dem Aufrufen IStiDevice::RawReadDatamü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::RawReadData- 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) |