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
Aucun
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 clone et informer le matériel de l’annulation.
Enfin, le minidriver doit appeler KsStreamPointerDelete pour supprimer le clone et le contexte 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 entraîner un blocage des applications associées.
AVStrMiniCancelCallback est appelée avec le verrou de rotation de la file d’attente maintenu, par conséquent à DISPATCH_LEVEL. En conséquence, la routine de rappel ne peut pas effectuer une manipulation de file d’attente ou des fonctions d’appel qui acquièrent un mutex.
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 | Bureau |
| d’en-tête | ks.h (include Ks.h) |