Función de devolución de llamada PFNKSPININITIALIZEALLOCATOR (ks.h)
Un minidriver de AVStream AVStrMiniInitializeAllocator rutina inicializa un asignador que se asociará a un pin.
Sintaxis
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Parámetros
[in] Pin
Puntero a una estructura de KSPIN que describe el pin con el que se va a asociar el asignador.
[in] AllocatorFraming
Puntero a una estructura KSALLOCATOR_FRAMING que describe los requisitos de marco que debe usar el asignador.
[out] Context
Puntero a un contexto para el asignador que se pasará como parámetro a las demás rutinas de esta estructura. Por ejemplo, el controlador podría almacenar estructuras de marco de anclaje o asignador para referencia posterior por las demás rutinas de devolución de llamada. Tenga en cuenta que otras rutinas para KSALLOCATOR_DISPATCH deben tener al menos una manera indirecta de hacer referencia a Pin. (Por ejemplo, AVStrMiniAllocate tendrá que tener acceso a la información de AllocatorFraming para Piny Context es el único parámetro que va a pasar AVStream).
Valor devuelto
AVStrMiniInitializeAllocator debe devolver STATUS_SUCCESS o el código de error que recibió al intentar crear el asignador.
Observaciones
El minidriver especifica la dirección de esta rutina en el initializeAllocator miembro de su estructura de KSALLOCATOR_DISPATCH. El minidriver pasa esta estructura al controlador de clase en KSPIN_DISPATCH.
Tenga en cuenta que los asignadores en modo kernel no pueden asignar fotogramas que podrían llegar al modo de usuario.
AVStream llama avStrMiniInitializeAllocator para inicializar el asignador especificado. El controlador de esta rutina debe prepararse para controlar la asignación de memoria y las solicitudes gratuitas.
Para obtener más información, vea asignadores de KS.
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) |