função CM_Get_Device_Interface_Property_KeysW (cfgmgr32.h)

A função CM_Get_Device_Interface_Property_Keys recupera uma matriz de chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma interface do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_Interface_Property_KeysW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

Parâmetros

[in] pszDeviceInterface

Ponteiro para uma cadeia de caracteres que identifica a instância da interface do dispositivo da qual recuperar as chaves de propriedade.

[out, optional] PropertyKeyArray

Ponteiro para um buffer que recebe uma matriz de valores do tipo DEVPROPKEY, em que cada valor é uma chave de propriedade do dispositivo que representa uma propriedade de dispositivo definida para a interface do dispositivo. O ponteiro é opcional e pode ser NULL

[in, out] PropertyKeyCount

O tamanho, em unidades do tipo DEVPROPKEY, do buffer PropertyKeyArray . Se PropertyKeyArray estiver definido como NULL, *PropertyKeyCount deverá ser definido como zero. Como saída, se PropertyKeyArray não for grande o suficiente para manter todos os dados da chave de propriedade, CM_Get_Device_Interface_Property_Keys retornará a contagem das chaves, em *PropertyKeyCount.

[in] ulFlags

Reservado. Deve ser definido como zero.

Retornar valor

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_Device_Interface_Property_Keys faz parte do Modelo de Propriedade do Dispositivo Unificado.

Requisitos

Confira também

SetupDiGetDeviceInterfacePropertyKeys