KsStreamPointerGetIrp, fonction (ks.h)
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 |