KsOpenDefaultDevice, fonction (ksproxy.h)

Article
02/07/2025

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 de retour

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

Remarques

La fonction KsOpenDefaultDevice transmet un pointeur à Catégorie dans un appel à la fonction SetupDiGetClassDevs pour obtenir un handle à la liste des appareils PnP. Pour plus d’informations sur le masque de bits ACCESS_MASK et SetupDiGetClassDevs, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	ksproxy.h (include Ksproxy.h)
bibliothèque	Ksproxy.lib

Partager via