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 retournée
KsStreamPointerLock retourne soit STATUS_SUCCESS, indiquant que le pointeur de flux a été verrouillé, soit un code d’erreur approprié. STATUS_DEVICE_NOT_READY est le code d’erreur habituel indiquant que le cadre n’a pas pu être verrouillé. Ce code d’erreur signifie fréquemment que le frame vers lequel StreamPointer pointait a été annulé.
Remarques
Un pointeur de flux verrouillé garantit qu’une trame de données est associée au pointeur de flux et que ce frame n’est pas annulé tant que le verrou est maintenu. Le minidriver doit verrouiller un pointeur de flux avant de tenter d’accéder aux données vers lesquelles 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/regroupements 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é.
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 |