Função CM_Get_DevNode_PropertyW (cfgmgr32.h)

A função CM_Get_DevNode_Property recupera uma propriedade de instância do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Get_DevNode_PropertyW(
  [in]      DEVINST          dnDevInst,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags
);

Parâmetros

[in] dnDevInst

Identificador de instância do dispositivo associado ao computador local.

[in] PropertyKey

Ponteiro para uma estrutura DEVPROPKEY que representa a chave de propriedade do dispositivo da propriedade de instância do dispositivo solicitada.

[out] PropertyType

Ponteiro para uma variável do tipo DEVPROPTYPE que recebe o identificador property-data-type da propriedade de instância do dispositivo solicitada, em que o identificador property-data-type é o OR bit a bit entre um identificador de tipo de dados base e, se o tipo de dados base for modificado, um modificador de tipo de dados de propriedade.

[out] PropertyBuffer

Ponteiro para um buffer que recebe a propriedade de instância de dispositivo solicitada. CM_Get_DevNode_Property recupera a propriedade solicitada somente se o buffer for grande o suficiente para manter todos os dados de valor da propriedade. O ponteiro pode ser NULL.

[in, out] PropertyBufferSize

O tamanho, em bytes, do buffer PropertyBuffer . Se PropertyBuffer estiver definido como NULL, *PropertyBufferSize deverá ser definido como zero. Como saída, se o buffer não for grande o suficiente para conter todos os dados de valor da propriedade, CM_Get_DevNode_Property retornará o tamanho dos dados, em bytes, em *PropertyBufferSize.

[in] ulFlags

Reservado. Deve ser definido como zero.

Valor retornado

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

CM_Get_DevNode_Property faz parte do Modelo de Propriedade de Dispositivo Unificado.

Requisitos

Confira também

SetupDiGetDeviceProperty