KsReferenceBusObject, fonction (ks.h)

Fait référence à l’objet d’appareil physique de bus.

Syntaxe

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Paramètres

[in] Header

Pointe vers un en-tête précédemment alloué par KsAllocateDeviceHeader qui contient également l’objet de pile d’appareils PnP.

Valeur de retour

Retourne STATUS_SUCCESS si la référence a réussi, sinon une erreur telle que STATUS_INSUFFICIENT_RESOURCES.

Remarques

Cette fonction est utilisée par les filtres qui utilisent l’en-tête de l’appareil pour suivre leur pile d’objets PnP. Cela est normalement appelé sur une ouverture réussie du filtre lorsque le bus pour cet appareil nécessite une telle référence (par exemple des appareils logiciels) et est mis en correspondance par un appel à KsDereferenceBusObject sur une fermeture de cette instance de filtre. L’appelant doit avoir précédemment appelé KsSetDevicePnpAndBaseObject pour définir l’objet de pile d’appareils PnP. Cette opération aurait été effectuée dans la fonction AddDevice PnP. Si l’objet n’a pas été référencé précédemment, l’espace d’interface est alloué et la fonction utilise l’objet d’appareil PnP pour acquérir l’interface de référencement de bus. Il appelle ensuite la méthode ReferenceDeviceObject sur cette interface. L’interface elle-même est libérée et libérée lorsque l’en-tête de l’appareil est libéré.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib