Fonction de rappel PFNKSSTREAMPOINTER (ks.h)
AVStream appelle la routine AVStrMiniCancelCallback d’un minidriver lorsque l’IRP associé à un pointeur de flux cloné est annulé. Cette routine est facultative.
Syntaxe
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Paramètres
[in] StreamPointer
Pointeur vers le clone KSSTREAM_POINTER associé à l’IRP qui a été annulé. StreamPointer a été créé par un appel à KsStreamPointerClone.
Valeur de retour
None
Remarques
Le minidriver spécifie l’adresse de cette routine dans le paramètre CancelCallback de KsStreamPointerClone.
Dans AVStrMiniCancelCallback, le minidriver doit définir toutes les références au pointeur clone sur NULL.
En outre, le minidriver doit supprimer toutes les informations de contexte liées au pointeur de clone et informer le matériel de l’annulation.
Enfin, le minidriver doit appeler KsStreamPointerDelete pour supprimer le clone et le contexte qui lui est associé. Si le minidriver ne supprime pas le clone, l’IRP conserve un nombre de références et n’est pas terminé, ce qui peut provoquer le blocage des applications associées.
AVStrMiniCancelCallback est appelé avec le verrou de rotation de la file d’attente maintenu, donc à DISPATCH_LEVEL. Par conséquent, la routine de rappel ne peut pas effectuer de manipulation de file d’attente ou de fonctions d’appel qui acquièrent un mutex.
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 | Desktop (Expérience utilisateur) |
| En-tête | ks.h (inclure Ks.h) |