Función de devolución de llamada PFNKSSTREAMPOINTER (ks.h)
AVStream llama a la AVStrMiniCancelCallback de un minidriver rutina cuando se cancela el IRP asociado a un puntero de secuencia clonado. Esta rutina es opcional.
Sintaxis
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Parámetros
[in] StreamPointer
Puntero al clon KSSTREAM_POINTER que está asociado al IRP que se canceló. streamPointer se creó mediante una llamada a KsStreamPointerClone.
Valor devuelto
Ninguno
Observaciones
El minidriver especifica la dirección de esta rutina en el parámetro CancelCallback de KsStreamPointerClone.
En AVStrMiniCancelCallback, el minidriver debe establecer todas las referencias al puntero clonado en NULL.
Además, el minidriver debe quitar cualquier información de contexto relacionada con el puntero de clonación y notificar al hardware sobre la cancelación.
Por último, el minidriver debe llamar a KsStreamPointerDelete para eliminar el clon y el contexto asociado a él. Si el minidriver no elimina el clon, el IRP conservará un recuento de referencias y no se completará, lo que posiblemente provocará que las aplicaciones relacionadas se bloquee.
se llama a avStrMiniCancelCallback con el bloqueo de giro de la cola mantenido, por lo tanto, en DISPATCH_LEVEL. En consecuencia, la rutina de devolución de llamada no puede realizar la manipulación de colas ni las funciones de llamada que adquieren una exclusión mutua.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ks.h (incluya Ks.h) |