KsOpenDefaultDevice, fonction (ksproxy.h)

La fonction KsOpenDefaultDevice ouvre un handle sur le premier appareil répertorié dans la catégorie Plug-and-Play (PnP) spécifiée.

Syntaxe

KSDDKAPI HRESULT KsOpenDefaultDevice(
  [in]  REFGUID     Category,
  [in]  ACCESS_MASK Access,
  [out] PHANDLE     DeviceHandle
);

Paramètres

[in] Category

Identificateur de la catégorie PnP à énumérer.

[in] Access

Masque de bits ACCESS_MASK spécifiant comment accéder à l’appareil par défaut.

[out] DeviceHandle

Pointeur vers une variable qui reçoit le handle vers l’appareil par défaut ouvert.

Valeur retournée

Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

La fonction KsOpenDefaultDevice transmet un pointeur vers Category dans un appel à la fonction SetupDiGetClassDevs pour obtenir un handle vers la liste des appareils PnP. Pour plus d’informations sur le masque de bits ACCESS_MASK et SetupDiGetClassDevs, consultez la documentation Microsoft Windows SDK.

Configuration requise