Aplicar configurações de propriedade wia ao hardware
Quando um aplicativo WIA inicia uma transferência de dados, o serviço WIA dá ao minidriver WIA a oportunidade de aplicar as configurações atuais da propriedade WIA e aplicar quaisquer configurações específicas do dispositivo ao hardware. Em seguida, o serviço WIA chama o método IWiaMiniDrv::d rvWriteItemProperties antes de chamar o método IWiaMiniDrv::d rvAcquireItemData . O último método é chamado somente quando um aplicativo WIA inicia uma transferência de dados. O minidriver WIA deve usar as funções de serviço WIA para ler as propriedades em sua própria árvore de itens de driver.
Implementar IWiaMiniDrv::d rvWriteItemProperties
O serviço WIA chama o método IWiaMiniDrv::d rvWriteItemProperties depois que o cliente solicita uma transferência de dados. O serviço WIA chama esse método antes de fazer uma chamada para IWiaMiniDrv::d rvAcquireItemData. O minidriver WIA deve confirmar as configurações necessárias para o hardware antes de retornar desse método.
Quando esse método é chamado, o minidriver wia foi confirmado para executar uma transferência de dados. O serviço WIA falhará em qualquer aplicativo que tente adquirir dados no momento com um código de erro WIA_ERROR_BUSY.
O exemplo a seguir mostra uma implementação do método IWiaMiniDrv::d rvWriteItemProperties :
HRESULT _stdcall CWIADevice::drvWriteItemProperties(
BYTE *pWiasContext,
LONG lFlags,
PMINIDRV_TRANSFER_CONTEXT pmdtc,
LONG *plDevErrVal)
{
//
// If the caller did not pass in the correct parameters,
// then fail the call with E_INVALIDARG.
//
if (!pWiasContext) {
return E_INVALIDARG;
}
if (!pmdtc) {
return E_INVALIDARG;
}
if (!plDevErrVal) {
return E_INVALIDARG;
}
HRESULT hr = S_OK;
*plDevErrVal = 0;
PROPVARIANT pv[2];
PROPSPEC ps[2] = {
{PRSPEC_PROPID, WIA_IPS_XRES},
{PRSPEC_PROPID, WIA_IPS_YRES}
};
//
// initialize propvariant structures
//
pv[0].vt = VT_I4; // X resolution is a LONG value
pv[1].vt = VT_I4; // Y resolution is a LONG value
//
// read 2 WIA item properties (X and Y resolution)
//
hr = wiasReadMultiple(pWiasContext, 2, ps, pv, NULL);
if (hr == S_OK) {
//
// write current X and Y resolution values, read from the
// the WIA property set, and write them to the device.
//
hr = SetMyDeviceXResolution(pv[0].lVal);
if(S_OK == hr) {
hr = SetMyDeviceYResolution(pv[1].lVal);
if(FAILED(hr)) {
//
// could not set Y resolution to device
//
}
} else {
//
// could not set X resolution to device
//
}
}
return hr;
}