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

Voir aussi

KsStreamPointerUnlock