Funzione di callback PFNKSSTREAMPOINTER (ks.h)
AVStream chiama una routine AVStrMiniCancelCallback di un minidriver quando l'IRP associato a un puntatore di flusso clonato viene annullato. Questa routine è facoltativa.
Sintassi
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Parametri
[in] StreamPointer
Puntatore al clone KSSTREAM_POINTER associato all'IRP annullato. StreamPointer è stato creato da una chiamata a KsStreamPointerClone.
Valore restituito
nessuno
Osservazioni
Il minidriver specifica l'indirizzo di questa routine nel parametro CancelCallback di KsStreamPointerClone.
In AVStrMiniCancelCallback, il minidriver deve impostare tutti i riferimenti sul puntatore clone su NULL.
Inoltre, il minidriver deve rimuovere tutte le informazioni di contesto correlate al puntatore clone e notificare all'hardware l'annullamento.
Infine, il minidriver deve chiamare KsStreamPointerDelete per eliminare il clone e il contesto associato. Se il minidriver non elimina il clone, l'IRP manterrà un conteggio dei riferimenti e non verrà completato, causando l'arresto anomalo delle applicazioni correlate.
AVStrMiniCancelCallback viene chiamato con il blocco di rotazione della coda mantenuto, quindi in DISPATCH_LEVEL. Di conseguenza, la routine di callback non può eseguire la manipolazione della coda o chiamare funzioni che acquisiscono un mutex.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ks.h (include Ks.h) |