KsStreamPointerAdvance, fonction (ks.h)
La fonction KsStreamPointerAdvance avance un pointeur de flux vers la trame de données suivante.
Syntaxe
KSDDKAPI NTSTATUS KsStreamPointerAdvance(
[in] PKSSTREAM_POINTER StreamPointer
);
Paramètres
[in] StreamPointer
Pointeur vers une structure de KSSTREAM_POINTER représentant le pointeur de flux à avancer pour référencer la trame de données disponible suivante.
Valeur retournée
KsStreamPointerAdvance retourne STATUS_SUCCESS pour indiquer une progression réussie. Dans le cas contraire, elle retourne un code d’erreur. STATUS_DEVICE_NOT_READY est le code d’erreur le plus souvent retourné et indique souvent que le verrouillage du pointeur de flux après l’avancement a échoué. En d’autres termes, StreamPointer référence la dernière image de la file d’attente.
Remarques
Si StreamPointer est verrouillé au moment de l’appel, AVStream le déverrouille avant de l’avancer. Une fois avancé, le pointeur de flux est remis dans son état d’origine (verrouillé ou déverrouillé) sur le nouveau cadre.
Une tentative d’avancement d’un pointeur de flux qui est déverrouillé réussit toujours et retourne STATUS_SUCCESS. Étant donné que le pointeur de flux n’est pas verrouillé, il n’existe aucun moyen de déterminer si le pointeur de flux fait référence aux données réelles. Le minidriver doit tenter un verrou pour déterminer si le pointeur de flux qui vient d’être avancé fait référence ou non à une trame de données.
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 |