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

Vedi anche

WIA_PROPERTY_CONTEXT

wiasFreePropContext

wiasValidateItemProperties