Función de devolución de llamada PFNKSSTREAMPOINTER (ks.h)
AVStream llama a la rutina AVStrMiniCancelCallback de un minidriver cuando se cancela el IRP asociado a un puntero de flujo clonado. Esta rutina es opcional.
Sintaxis
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Parámetros
[in] StreamPointer
Puntero al clon KSSTREAM_POINTER asociado al IRP que se canceló. StreamPointer se creó mediante una llamada a KsStreamPointerClone.
Valor devuelto
None
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 de clonación 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 número de la cola, 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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Escritorio |
| Encabezado | ks.h (incluye Ks.h) |