Metodo IWiaMiniDrv::d rvGetDeviceErrorStr (wiamindr_lh.h)

Articolo
02/27/2024

Il metodo IWiaMiniDrv::d rvGetDeviceErrorStr esegue il mapping di un codice di errore a una stringa Unicode che descrive l'errore.

Sintassi

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

Parametri

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Specifica il valore di errore del dispositivo di cui eseguire il mapping a una stringa. Il valore zero indica che non si è verificato alcun errore.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Riservato.

__MIDL__IWiaMiniDrv0041

plDevErr [out]

Punta a una posizione di memoria che riceverà un codice di stato per questo metodo. Se questo metodo restituisce S_OK, il valore archiviato sarà zero. In caso contrario, un codice di errore specifico del minidriver verrà archiviato nella posizione a cui punta questo parametro.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

Punta a una posizione di memoria che riceverà l'indirizzo di una stringa che descrive l'errore.

Valore restituito

In caso di esito positivo, il metodo deve restituire S_OK e cancellare il valore di errore del dispositivo a cui punta plDevErr. Se il minidriver non implementa completamente questo metodo, il metodo deve restituire E_NOTIMPL. Se il minidriver non riconosce il valore di errore passato a questo metodo, il metodo deve restituire E_INVALIDARG. Se il metodo ha esito negativo, deve restituire un codice di errore COM standard e inserire un valore di codice di errore specifico del minidriver nella memoria a cui punta plDevErr.

Commenti

Per ottenere una stringa di errore che descrive un valore di errore generato dal minidriver specifico del dispositivo, il servizio WIA chiama il metodo IWiaMiniDrv::d rvGetDeviceErrorStr . In risposta a questa chiamata, il minidriver deve usare CoTaskMemAlloc per allocare memoria che conterrà una stringa Unicode localizzata corrispondente al codice di errore passato al minidriver. Il servizio WIA (o un'applicazione) libera la memoria. È probabile che un'applicazione visualizzi la stringa, quindi deve essere significativa per un utente finale. La stringa deve essere caricata da un file di risorse, in modo che possa essere localizzata in un'ampia gamma di lingue.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wiamindr_lh.h (include Wiamindr.h)

Condividi tramite