Función KsPinRegisterIrpCompletionCallback (ks.h)

La función KsPinRegisterIrpCompletionCallback registra una rutina de devolución de llamada definida por el minidriver para un pin especificado. AVStream llama a la rutina proporcionada por el minidriver cuando un IRP completa un paso alrededor del circuito y el marco asociado al IRP está a punto de reciclarse o retirarse.

Sintaxis

void KsPinRegisterIrpCompletionCallback(
  [in] PKSPIN                Pin,
  [in] PFNKSPINIRPCOMPLETION IrpCompletion
);

Parámetros

[in] Pin

Puntero a la estructura KSPIN para la que se va a registrar una devolución de llamada de finalización.

[in] IrpCompletion

Este parámetro proporciona la dirección de una rutina AVStrMiniPinIrpCompletion a la que se llamará cuando un IRP completa su recorrido del circuito y está a punto de reciclarse o retirarse.

Valor devuelto

None

Observaciones

Se debe llamar a KsPinRegisterIrpCompletionCallback en IRQL=PASSIVE_LEVEL antes de que el pin entre en KSSTATE_ACQUIRE. Para obtener más información sobre los estados de anclaje, vea KSSTATE.

A esta función se le llama con frecuencia desde el envío de creación de patillas. Consulte KSPIN_DISPATCH.

KsPinRegisterIrpCompletionCallback solo es útil en los pines de origen irP y normalmente se usa en patillas de origen de datos. Para un pin de origen de datos, la devolución de llamada se realiza una vez que el IRP se completa de nuevo en el pin y está a punto de reciclarse. Sin embargo, en el caso de un pin receptor de datos, la devolución de llamada no está vinculada directamente a la finalización de IRP. AVStream todavía realiza la devolución de llamada cuando el IRP vuelve al reciclaje. Esta devolución no se produce hasta que IRP ha pasado por todas las colas que necesitan usar los datos que contiene. Para obtener información sobre los patillas de origen o receptor de IRP frente a los pins de origen o receptor de datos, consulte los miembros DataFlow y Communication de la estructura de KSPIN_DESCRIPTOR .

KsPinRegisterIrpCompletionCallback difiere significativamente de KsPinRegisterFrameReturnCallback en que esta rutina no coloca el pin en ningún modo nuevo; simplemente registra una rutina de devolución de llamada.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino Universal
Encabezado ks.h (incluya Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL

Consulte también

AVStrMiniPinCreate

AVStrMiniPinIrpCompletion

KSPIN

KSPIN_DISPATCH

KSSTATE

KsPinRegisterFrameReturnCallback