Función wiasCreatePropContext (wiamdef.h)
La función wiasCreatePropContext asigna un contexto de propiedad para indicar qué propiedades de un elemento está cambiando la aplicación.
Sintaxis
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
Parámetros
cPropSpec
Especifica el número total de estructuras PROPSPEC en la matriz pPropSpec .
[in] pPropSpec
Puntero al primer elemento de una matriz de estructuras PROPSPEC que identifican qué propiedades cambian.
cProps
Especifica el número de identificadores de propiedad almacenados en este contexto.
[in, optional] pProps
Puntero al primer elemento de una matriz de identificadores de propiedad que indican las propiedades que se van a colocar en este contexto de propiedad.
[in] pContext
Puntero a una estructura de WIA_PROPERTY_CONTEXT que contiene un contexto de propiedad.
Valor devuelto
Si se ejecuta correctamente, la función devuelve S_OK. Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error de WIA.
Comentarios
Esta función asigna un contexto de propiedad y rellena sus valores. Esta función se usa generalmente en wiasValidateItemProperties donde se validan las propiedades escritas por la aplicación.
Las entradas del contexto de propiedad son identificadores de las propiedades que tienen dependientes o que dependen de otras propiedades. Se usa un contexto para marcar qué propiedades se están cambiando. Cuando el contexto de propiedad ya no es necesario, debe liberarse mediante una llamada a wiasFreePropContext.
Las propiedades en las que escribe una aplicación se especifican mediante la matriz pPropSpec . Las propiedades modificadas por la aplicación, así como las propiedades dependientes de las propiedades modificadas, se especifican mediante la matriz pProps . Solo se pueden especificar las propiedades que ha cambiado la aplicación (y las propiedades dependientes) en pProps.
Para obtener más información, consulte la estructura PROPSPEC .
Los controladores pueden especificar propiedades adicionales al crear un contexto de propiedad con wiasCreatePropContext.
Las siguientes propiedades siempre están presentes en 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
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamdef.h (incluye Wiamdef.h) |
| Library | Wiaservc.lib |
| Archivo DLL | Wiaservc.dll |