KsStreamPointerAdvance, fonction (ks.h)
La fonctionKsStreamPointerAdvance 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 KSSTREAM_POINTER représentant le pointeur de flux à avancer pour référencer la trame de données disponible suivante.
Valeur de retour
KsStreamPointerAdvance retourne STATUS_SUCCESS pour indiquer une progression réussie. Elle retourne un code d’erreur dans le cas contraire. 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 fait référence au dernier cadre 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 placé dans son état d’origine (verrouillé ou déverrouillé) sur le nouveau frame.
Une tentative d’avancement d’un pointeur de flux 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 nouvellement avancé fait référence à une trame de données ou non.
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 |