KsStreamPointerGetIrp, fonction (ks.h)
La fonction KsStreamPointerGetIrp retourne l’IRP associé à la trame 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 au frame pour lequel l’IRP associé est retourné.
[out, optional] FirstFrameInIrp
Pointeur vers une valeur BOOLEAN fournie par l’appelant définie sur TRUE lors du retour si le cadre référencé par StreamPointer est le premier frame dans l’IRP retourné et FALSE si ce n’est pas le cas. Si NULL, AVStream ne teste pas cette condition.
[out, optional] LastFrameInIrp
Pointeur vers une valeur BOOLEAN fournie par l’appelant définie sur TRUE si le cadre référencé par le pointeur de flux est le dernier frame dans l’IRP retourné et FALSE si ce n’est pas le cas. Si NULL, AVStream ne teste pas cette condition.
Valeur de retour
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 de 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 au premier et/ou dernier cadre contenu dans l’IRP retourné.
StreamPointer doit être verrouillée 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 doit êtrenull au moment de l’appel afin que AVStream remplisse ces valeurs.
Voir également pointeurs de flux.
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 | <=DISPATCH_LEVEL |