KsStreamPointerLock, fonction (ks.h)
La fonction KsStreamPointerLock tente de verrouiller le pointeur de flux spécifié.
Syntaxe
KSDDKAPI NTSTATUS KsStreamPointerLock(
[in] PKSSTREAM_POINTER StreamPointer
);
Paramètres
[in] StreamPointer
Pointeur vers une structure KSSTREAM_POINTER représentant le pointeur de flux à verrouiller.
Valeur de retour
KsStreamPointerLock retourne STATUS_SUCCESS, indiquant que le pointeur de flux a été verrouillé ou un code d’erreur approprié. STATUS_DEVICE_NOT_READY est le code d’erreur habituel indiquant que le frame n’a pas pu être verrouillé. Ce code d’erreur signifie fréquemment que l’image vers laquelle StreamPointer pointait a été annulée.
Remarques
Un pointeur de flux verrouillé garantit qu’il existe une trame de données associée au pointeur de flux et que cette trame n’est pas annulée tant que le verrou est conservé. Le minidriver doit verrouiller un pointeur de flux avant de tenter d’accéder aux données auxquelles pointe le pointeur de flux.
Si l’épingle référencée par le pointeur de flux spécifie que les mappages de nuages de points/de collecte DMA doivent être générés à l’aide de KSPIN_FLAG_GENERATE_MAPPINGS, AVStream génère les mappages lorsque le pointeur de flux est verrouillé.
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 |