función CM_Get_DevNode_PropertyW (cfgmgr32.h)

La función CM_Get_DevNode_Property recupera una propiedad de instancia de dispositivo.

Sintaxis

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 instancia de dispositivo enlazado al equipo local.

[in] PropertyKey

Puntero a una estructura DEVPROPKEY que representa la clave de propiedad del dispositivo de la propiedad de instancia de dispositivo solicitada.

[out] PropertyType

Puntero a una variable con tipo DEVPROPTYPE que recibe el identificador property-data-type de la propiedad de instancia de dispositivo solicitada, donde el identificador property-data-type es el OR bit a bit entre un identificador de tipo de datos base y, si se modifica el tipo de datos base, un modificador property-data-type.

[out] PropertyBuffer

Puntero a un búfer que recibe la propiedad de instancia de dispositivo solicitada. CM_Get_DevNode_Property recupera la propiedad solicitada solo si el búfer es lo suficientemente grande como para contener todos los datos de valor de propiedad. El puntero puede ser NULL.

[in, out] PropertyBufferSize

Tamaño, en bytes, del búfer PropertyBuffer . Si PropertyBuffer se establece en NULL, *PropertyBufferSize debe establecerse en cero. Como salida, si el búfer no es lo suficientemente grande como para contener todos los datos de valor de propiedad, CM_Get_DevNode_Property devuelve el tamaño de los datos, en bytes, en *PropertyBufferSize.

[in] ulFlags

Reservado. Debe establecerse en cero.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

CM_Get_DevNode_Property forma parte del modelo de propiedades de dispositivo unificado.

Requisitos

Consulte también

SetupDiGetDeviceProperty