Função wiasCreatePropContext (wiamdef.h)
A função wiasCreatePropContext aloca um contexto de propriedade para indicar quais das propriedades de um item estão sendo alteradas pelo aplicativo.
Sintaxe
HRESULT wiasCreatePropContext(
ULONG cPropSpec,
[in] PROPSPEC *pPropSpec,
ULONG cProps,
[in, optional] PROPID *pProps,
[in] WIA_PROPERTY_CONTEXT *pContext
);
Parâmetros
cPropSpec
Especifica o número total de estruturas PROPSPEC na matriz pPropSpec .
[in] pPropSpec
Ponteiro para o primeiro elemento de uma matriz de estruturas PROPSPEC que identificam quais propriedades estão sendo alteradas.
cProps
Especifica o número de identificadores de propriedade armazenados nesse contexto.
[in, optional] pProps
Ponteiro para o primeiro elemento de uma matriz de identificadores de propriedade que indicam as propriedades a serem colocadas nesse contexto de propriedade.
[in] pContext
Ponteiro para uma estrutura WIA_PROPERTY_CONTEXT que contém um contexto de propriedade.
Retornar valor
Em caso de êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia.
Comentários
Essa função aloca um contexto de propriedade e preenche seus valores. Essa função geralmente é usada em wiasValidateItemProperties em que as propriedades gravadas pelo aplicativo são validadas.
As entradas no contexto de propriedade são identificadores para propriedades que têm dependentes ou dependem de outras propriedades. Um contexto é usado para marcar quais propriedades estão sendo alteradas. Quando o contexto da propriedade não for mais necessário, ele deverá ser liberado por uma chamada para wiasFreePropContext.
As propriedades nas quais um aplicativo grava são especificadas pela matriz pPropSpec . As propriedades que foram alteradas pelo aplicativo, bem como todas as propriedades dependentes das propriedades alteradas, são especificadas pela matriz pProps . Somente as propriedades que foram alteradas pelo aplicativo (e quaisquer propriedades dependentes) podem ser especificadas em pProps.
Para obter mais informações. consulte a estrutura PROPSPEC .
Os drivers podem especificar propriedades adicionais ao criar um contexto de propriedade com wiasCreatePropContext.
As seguintes propriedades estão sempre presentes em 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 | Valor |
---|---|
Plataforma de Destino | Área de Trabalho |
Cabeçalho | wiamdef.h (inclua Wiamdef.h) |
Biblioteca | Wiaservc.lib |
DLL | Wiaservc.dll |