funzione wiasCreatePropContext (wiamdef.h)
La funzione wiasCreatePropContext alloca un contesto di proprietà per indicare quali proprietà di un elemento vengono modificate dall'applicazione.
Sintassi
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
Parametri
cPropSpec
Specifica il numero totale di strutture PROPSPEC nella matrice pPropSpec .
[in] pPropSpec
Puntatore al primo elemento di una matrice di strutture PROPSPEC che identificano le proprietà che cambiano.
cProps
Specifica il numero di identificatori di proprietà archiviati in questo contesto.
[in, optional] pProps
Puntatore al primo elemento di una matrice di identificatori di proprietà che indicano le proprietà da inserire in questo contesto di proprietà.
[in] pContext
Puntatore a una struttura WIA_PROPERTY_CONTEXT che contiene un contesto di proprietà.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK. Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.
Commenti
Questa funzione alloca un contesto di proprietà e inserisce i relativi valori. Questa funzione viene generalmente usata in wiasValidateItemProperties in cui vengono convalidate le proprietà scritte dall'applicazione.
Le voci nel contesto della proprietà sono identificatori per le proprietà che hanno dipendenti o dipendono da altre proprietà. Viene usato un contesto per contrassegnare le proprietà da modificare. Quando il contesto della proprietà non è più necessario, deve essere liberato da una chiamata a wiasFreePropContext.
Le proprietà a cui un'applicazione scrive vengono specificate dalla matrice pPropSpec . Le proprietà modificate dall'applicazione, nonché le proprietà dipendenti dalle proprietà modificate, vengono specificate dalla matrice pProps . È possibile specificare solo le proprietà modificate dall'applicazione (e le proprietà dipendenti) in pProps.
Per altre informazioni. vedere la struttura PROPSPEC .
I driver possono specificare proprietà aggiuntive durante la creazione di un contesto di proprietà con wiasCreatePropContext.
Le proprietà seguenti sono sempre presenti in WIA_PROPERTY_CONTEXT:
WIA_IPA_DATATYPE
WIA_IPA_DEPTH
WIA_IPS_XRES
WIA_IPS_XPOS
WIA_IPS_XEXTENT
WIA_IPA_PIXELS_PER_LINE
WIA_IPS_YRES
WIA_IPS_YPOS
WIA_IPS_YEXTENT
WIA_IPA_NUMBER_OF_LINES
WIA_IPS_CUR_INTENT
WIA_IPA_TYMED
WIA_IPA_FORMAT
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |