Función de devolución de llamada PFNKSDEVICECREATE (ks.h)
Una rutina AVStrMiniDeviceAdd de AVStream minidriver notifica al minidriver que se ha completado la rutina AddDevice de PnP de AVStream.
Sintaxis
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parámetros
[in] Device
Puntero a una estructura KSDEVICE que describe el objeto de dispositivo funcional (FDO) que se acaba de crear.
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 a AddDevice relacionada. Consulte la sección Comentarios a continuación para obtener más detalles.
Comentarios
El minidriver especifica la dirección de esta rutina en el miembro Add de su estructura KSDEVICE_DISPATCH .
AVStream llama a AVStrMiniDeviceAdd desde su rutina AddDevice predeterminada, en el momento 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 la estructura KSDEVICE y se ha inicializado, y se ha asignado el encabezado del dispositivo KS.
Los minicontroladores 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 NINGÚN IRP implicado. Solo se llama a la rutina en IRQL = PASSIVE_LEVEL.
Esta rutina es opcional.
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) |
| IRQL | PASSIVE_LEVEL (consulte la sección Comentarios) |