Compartilhar via

Verificar esquema de perfil

  • Artigo

O Esquema de Perfil de Verificação define um formato XML que pode ser usado para armazenar as propriedades de itens de WIA (Aquisição de Imagens do Windows), como scanners e câmeras. Esses arquivos persistentes permitem que os aplicativos forneçam verificação automática sem exigir que os usuários se lembrem das configurações de propriedade dos itens.

Qualquer dispositivo IWiaItem2 pode ter um perfil de verificação. No entanto, itens IWiaItem2 de tipos WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_ROOT não podem ter perfis.

Os perfis de verificação são criados e gerenciados por meio das interfaces IScanProfile, IScanProfileMgr e IScanProfileUI . Os usuários do aplicativo podem modificar perfis de maneiras limitadas usando o método IScanProfileUI::ScanProfileDialog .

Todos os perfis de verificação têm os seguintes elementos: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, e <Properties>. O perfil padrão de um dispositivo também tem um <Default> elemento .

O <ProfileGUID> elemento e o <DeviceID> elemento não podem ser alterados depois que o perfil de verificação é criado. Os valores do <ProfileName> elemento e do <WiaItem> elemento podem ser modificados. O <Default> elemento pode ser adicionado ou excluído. Isso pode ser feito programaticamente usando os métodos IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault . Essas propriedades também podem ser alteradas pelos usuários por meio do método IScanProfileUI::ScanProfileDialog .

O <Properties> elemento contém <Property> filhos. Use-os para adicionar qualquer item WIA ou propriedade de dispositivo ao perfil. Você também pode desenvolver seus próprios filhos de acquistão de <Property> imagem. Isso torna o Esquema de Perfil de Verificação extensível. (Para obter mais informações sobre como estender o esquema, consulte Definindo propriedades personalizadas, IScanProfile::GetProperty e IScanProfile::SetProperty.)

Aqui está o esquema de perfil de verificação completo. Segue um perfil de exemplo.

<?xml version="1.0"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema"
            targetNamespace="https://www.microsoft.com"
            xmlns="https://www.microsoft.com"
            elementFormDefault="qualified">

<xs:element name="ScanProfile">
            <xs:complexType>
            <xs:sequence>
                        <xs:element name="ProfileGUID" type="xs:string"/>
                        <xs:element name="DeviceID" type="xs:string"/>
<xs:element name="ProfileName" type="xs:string"/>
                        <xs:element name="Default" minOccurs="0">
                                    <xs:complexType>
                                    </xs:complexType>
                        </xs:element>
                        <xs:element name="WiaItem" type="xs:string"/>
                        <xs:element name="Properties" type="Properties"/>
            </xs:sequence>
            </xs:complexType>
</xs:element>
 
<xs:complexType name="Properties">
<xs:sequence>
            <xs:element name="Property" maxOccurs="unbounded" minOccurs="0">
            <xs:complexType>
            <xs:simpleContent>
                        <xs:extension base="xs:string">
                                    <xs:attribute name="id" type="xs:integer" use="required"/>
                                    <xs:attribute name="type" type="xs:integer" use="required"/>
                        </xs:extension>
            </xs:simpleContent>
            </xs:complexType>
            </xs:element>
</xs:sequence>
</xs:complexType>
 
</xs:schema>

Clique em Mostrar Exemplo para ver um perfil de exemplo.

<ScanProfile>
    <ProfileGUID>
        {F862E217-32B0-4396-987A-2191224925CD}
    </ProfileGUID>
    <DeviceID>
        {6BDD1FC6-810F-11D0-BEC7-08002BE2092F}\0001
    </DeviceID>
    <ProfileName>
        Last used settings
    </ProfileName>
    <WiaItem>
        {FB607B1F-43F3-488B-855B-FB703EC342A6}
    </WiaItem>
    <Properties>
        <Property id="4103" type="3">
            3
        </Property>
        <Property id="4106" type="72">
            {B96B3CAB-0728-11D3-9D7B-0000F81EF32E}
        </Property>
        <Property id="6147" type="3">
            300
        </Property>
        <Property id="6154" type="3">
            0
        </Property>
        <Property id="6155" type="3">
            0
        </Property>
    </Properties>
</ScanProfile>

Referência

IScanProfile::GetProperty

IScanProfile::SetProperty

Conceitual

Constantes de propriedade WIA

Definindo propriedades personalizadas