Función de devolución de llamada PFNKSDEVICECREATE (ks.h)
Una minidriver de AVStream AVStrMiniDeviceAdd rutina notifica al minidriver que la rutina PnP AddDevice avStream se ha completado.
Sintaxis
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parámetros
[in] Device
Puntero a una estructura de KSDEVICE que describe el objeto de dispositivo funcional (FDO) que acaba de crearse.
Valor devuelto
Debe devolver STATUS_SUCCESS o el código de error que se devolvió del intento de realizar la operación. Si el minidriver devuelve el estado de error, también se producirá un error en la llamada AddDevice relacionada. Consulte la sección Comentarios a continuación para obtener más detalles.
Observaciones
El minidriver especifica la dirección de esta rutina en el miembro Agregar de su estructura de KSDEVICE_DISPATCH.
AVStream llama a AVStrMiniDeviceAdd desde su rutina de AddDevice predeterminada, en tiempo de inicialización de KSDEVICE. En el momento en que se llama a esta rutina, se ha creado el objeto de dispositivo WDM (DEVICE_OBJECT), se ha creado el estructura de KSDEVICE y se ha inicializado y se ha asignado el encabezado del dispositivo KS.
Los minidrivers pueden usar esta rutina para asociar información de contexto con el objeto de dispositivo AVStream o para inicializar una extensión de dispositivo.
Si esta rutina devuelve un código de estado incorrecto, se producirá un error en la rutina AddDevice de AVStream. STATUS_PENDING no es un código de devolución legal porque no hay IRP implicado. Solo se llama a la rutina en IRQL = PASSIVE_LEVEL.
Esta rutina es opcional.
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) |
| irQL | PASSIVE_LEVEL (consulte la sección Comentarios) |