Función KsPinDataIntersection (ks.h)
La función KsPinDataIntersection controla la propiedad KSPROPERTY_PIN_DATAINTERSECTION a través de una función de devolución de llamada y realiza gran parte de la validación inicial de los parámetros que se pasan. KsPinDataIntersection llama a la función de devolución de llamada KStrIntersectHandler definida por el minidriver con cada rango de datos potencial después de que coincida con la lista de intervalos de datos asignados a esa factoría de patillas.
Sintaxis
KSDDKAPI NTSTATUS KsPinDataIntersection(
[in] PIRP Irp,
[in] PKSP_PIN Pin,
[out, optional] PVOID Data,
[in] ULONG DescriptorsCount,
[in] const KSPIN_DESCRIPTOR *Descriptor,
[in] PFNKSINTERSECTHANDLER IntersectHandler
);
Parámetros
[in] Irp
Especifica el IRP que describe la solicitud de propiedad.
[in] Pin
Especifica la propiedad específica que se está consultando.
[out, optional] Data
Especifica los datos específicos de la propiedad pin.
[in] DescriptorsCount
Especifica el número de estructuras descriptores.
[in] Descriptor
Especifica el puntero a la lista de estructuras de información de anclaje.
[in] IntersectHandler
Especifica la función de devolución de llamada KStrIntersectHandler definida por el minidriver para comparar un intervalo de datos.
Valor devuelto
La función KsPinDataIntersection devuelve STATUS_SUCCESS si se encuentra un intervalo coincidente, STATUS_NO_MATCH si no se encontró ningún intervalo coincidente o un error específico de la propiedad que se está controlando. Se llama al controlador de intersección KStrIntersectHandler definido por el minidriver proporcionado a KsPinDataIntersection con cada intervalo de datos proporcionado por el autor de la llamada hasta que se encuentre una coincidencia o se produzca un error.
Tenga en cuenta que la función de devolución de llamada KStrIntersectHandler definida por el minidriver tiene su propio conjunto de valores devueltos.
Comentarios
Una coincidencia puede producirse en tres condiciones: si el formato principal del intervalo pasado es un carácter comodín o coincide con un intervalo de generador de patillas, si el subformato es un carácter comodín o coincide, y si el especificador es un carácter comodín o coincide. Dado que el tamaño del intervalo de datos puede ser variable, no se valida más allá de comprobar que es al menos el tamaño de una estructura KSDATARANGE .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |