Funzione di callback PFNKSSTREAMPOINTER (ks.h)
AVStream chiama la routine AVStrMiniCancelCallback di un minidriver routine 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 al 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 spin 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Desktop |
| intestazione | ks.h (include Ks.h) |