KsGetObjectFromFileObject, fonction (ks.h)

Article
07/02/2025

La fonction KsGetObjectFromFileObject retourne le cast d’objets AVStream en PVOID à partir de FileObject.

Syntaxe

C++

KSDDKAPI PVOID KsGetObjectFromFileObject(
  [in] PFILE_OBJECT FileObject
);

Paramètres

[in] FileObject

Pointeur vers la structure FILE_OBJECT pour laquelle déterminer l’objet AVStream associé.

Valeur de retour

KsGetObjectFromFileObject renvoie un pointeur vers l’objet AVStream associé à FileObject (cast en PVOID). Par exemple, ce pointeur peut pointer vers un KSFILTER ou un KSPIN.

Remarques

La fonction KsGetObjectFromFileObject ne vérifie pas que l’objet de fichier est associé à un objet KS. Si ce n’est pas le cas, cela peut entraîner une erreur d’accès à la mémoire. Les développeurs de pilotes doivent envisager d’utiliser la gestion structurée des exceptions pour intercepter une exception possible.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib
IRQL	N’importe quel niveau