Partager via

KsStreamPointerGetIrp, fonction (ks.h)

  • Article

La fonction KsStreamPointerGetIrp retourne l’IRP associé à l’image référencée par le pointeur de flux donné.

Syntaxe

KSDDKAPI PIRP KsStreamPointerGetIrp(
  [in]            PKSSTREAM_POINTER StreamPointer,
  [out, optional] PBOOLEAN          FirstFrameInIrp,
  [out, optional] PBOOLEAN          LastFrameInIrp
);

Paramètres

[in] StreamPointer

Pointeur vers la structure KSSTREAM_POINTER qui fait référence à l’image pour laquelle l’IRP associé est retourné.

[out, optional] FirstFrameInIrp

Pointeur vers une valeur BOOLEAN fournie par l’appelant définie sur TRUE au retour si l’image référencée par StreamPointer est la première image de l’IRP retourné et FALSE si ce n’est pas le cas. Si la valeur est NULL, AVStream ne teste pas cette condition.

[out, optional] LastFrameInIrp

Pointeur vers une valeur BOOLEAN fournie par l’appelant définie sur TRUE si l’image référencée par le pointeur de flux est la dernière image de l’IRP retourné et FALSE si ce n’est pas le cas. Si la valeur est NULL, AVStream ne teste pas cette condition.

Valeur retournée

KsStreamPointerGetIrp retourne un pointeur vers l’IRP associé au frame référencé par le pointeur de flux donné, ou retourne NULL. Une valeur de retour NULL indique que le pointeur de flux n’est pas verrouillé.

Remarques

KsStreamPointerGetIrp peut également être utilisé pour déterminer si StreamPointer fait référence à la première et/ou dernière image contenue dans l’IRP retourné.

StreamPointer doit être verrouillé pour que KsStreamPointerGetIrp s’exécute correctement. Toute tentative d’appel de cette fonction avec un pointeur de flux déverrouillé entraîne une valeur de retour NULL .

FirstFrameInIrp et/ou LastFrameInIrp doivent être non NULL au moment de l’appel pour qu’AVStream remplisse ces valeurs.

Consultez également Stream Pointeurs.

Configuration requise

Condition requise Valeur
Client minimal 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 Universal
En-tête ks.h (inclure Ks.h)
Bibliothèque Ks.lib
IRQL <=DISPATCH_LEVEL

Voir aussi

KsStreamPointerGetMdl

KsStreamPointerLock