KsStreamPointerClone, fonction (ks.h)

Article
08/07/2023

La fonction KsStreamPointerClone crée un clone d’un pointeur de flux donné.

Syntaxe

KSDDKAPI NTSTATUS KsStreamPointerClone(
  [in]           PKSSTREAM_POINTER  StreamPointer,
  [in, optional] PFNKSSTREAMPOINTER CancelCallback,
  [in]           ULONG              ContextSize,
  [out]          PKSSTREAM_POINTER  *CloneStreamPointer
);

Paramètres

[in] StreamPointer

Pointeur vers une structure de KSSTREAM_POINTER représentant le pointeur de flux à cloner.

[in, optional] CancelCallback

facultatif. Pointeur vers une routine AVStrMiniCancelCallback fournie par minidriver. AVStream appelle cette routine si l’IRP associé à CloneStreamPointer est annulé.

[in] ContextSize

Ce paramètre indique le nombre d’octets d’informations de contexte minidriver que le pointeur de flux de clone obtenu doit avoir. Si ce n’est pas zéro, le nombre d’octets demandé est alloué immédiatement après le pointeur de flux retourné, et le champ Contexte de CloneStreamPointer pointe vers la mémoire allouée.

[out] CloneStreamPointer

Pointeur vers un pointeur vers une structure KSSTREAM_POINTER . Une fois l’opération de clonage terminée, CloneStreamPointer contient un pointeur vers l’adresse du pointeur de flux cloné.

Valeur retournée

KsStreamPointerClone retourne soit STATUS_SUCCESS, indiquant que l’opération de clonage s’est terminée normalement, soit un code d’erreur approprié.

Remarques

Le clone résultant fait initialement référence à la même trame de données que le pointeur de flux d’origine et est dans le même état (verrouillé ou déverrouillé). L’ajout d’un pointeur de flux de clone référençant une trame de données incrémente le nombre de références sur cette image particulière. Notez que le cadre en question, et donc l’IRP auquel appartient le cadre, n’est pas terminé tant que le nombre de références n’est pas passé à zéro.

Vous pouvez utiliser le paramètre ContextSize de cet appel pour réduire les appels d’allocation.

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