KsReferenceBusObject, fonction (ks.h)

Fait référence à l’objet d’appareil physique 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 retournée

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é lors d’une ouverture réussie du filtre lorsque le bus de cet appareil nécessite une telle référence (par exemple, des périphériques logiciels), et est mis en correspondance par un appel à KsDereferenceBusObject à une fermeture de ce filtre instance. L’appelant doit avoir précédemment également appelé KsSetDevicePnpAndBaseObject pour définir l’objet de pile d’appareils PnP. Cela aurait été effectué 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érence 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é.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib