Obtendo um objeto de instância de função

Artigo
06/15/2023

O minidriver WIA deve identificar o dispositivo de hardware atual e o serviço no qual ele está sendo executado. Para identificar esses itens, o minidriver obtém em tempo de execução o objeto instância de função do serviço descoberta de funções e lê as propriedades do dispositivo.

Para usar interfaces COM da Descoberta de Funções, o código do minidriver deve incluir o arquivo de cabeçalho FunctionDiscovery.h main, que está disponível no SDK do Windows Vista, como mostra o exemplo a seguir.

//
// Web Services Function Discovery main header:
//
#include <FunctionDiscovery.h>

Durante a inicialização, como pode acontecer no método IStiUSD::Initialize , o minidriver deve consultar a Descoberta de Função para obter o objeto de Instância de Função apropriado que representa o dispositivo de hardware. Para concluir essa consulta, use o procedimento a seguir (e os exemplos de código associados):

Etapa 1: Criar o objeto Function Discovery

//
// Function Discovery object
//
IFunctionDiscovery *pFunctionDiscovery = NULL;
CoCreateInstance(__uuidof(FunctionDiscovery),
                 NULL,
                 CLSCTX_INPROC_SERVER,
                 __uuidof(IFunctionDiscovery),
  (void**)&pFunctionDiscovery);

Etapa 2: Criar um objeto De consulta de coleção de instâncias

IFunctionInstanceCollectionQuery *pfiCollectionQuery = NULL;
pFunctionDiscovery->CreateInstanceCollectionQuery(FCTN_CATEGORY_PNP,
   NULL,
   FALSE,
   NULL,
   NULL,
   &pfiCollectionQuery);

Etapa 3: adicionar uma restrição ao objeto Instance Collection Query para especificar a ID PNPX (seu valor é recuperado com IStiDeviceControl::GetMyDevicePortName) como a restrição de consulta

PROPVARIANT PropVar = {0};
//
// Note that the wszDevicePath value is obtained by the WIA minidriver 
// calling IStiDeviceControl::GetMyDevicePortName during IStiUSD::Initialize
//
PropVariantInit(&PropVar);
PropVar.vt = VT_LPWSTR;
PropVar.pwszVal = (LPWSTR)wszDevicePath; 
pfiCollectionQuery->AddPropertyConstraint(PKEY_PNPX_ID, &PropVar, QC_EQUALS);

Etapa 4: Executar a consulta

IFunctionInstanceCollection *pfiCollection = NULL;
pfiCollectionQuery->Execute(&pfiCollection);

Etapa 5: Recuperar o objeto da Instância de Função retornado

//
// Function Instance object that represents our device instance
//
IFunctionInstance *pFunctionInstance;

pfiCollection->Item(0, &m_pFunctionInstance);

Para obter um exemplo de código que contém a declaração de uma classe de exemplo (CWSDDevice), consulte Exemplo de código para obter um objeto de instância de função.

Partilhar via