Función KsInitializeDevice (ks.h)
AVStream llama a la función KsInitializeDevice para inicializar la clase de dispositivo AVStream desde KsCreateDevice.
Sintaxis
KSDDKAPI NTSTATUS KsInitializeDevice(
[in] PDEVICE_OBJECT FunctionalDeviceObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PDEVICE_OBJECT NextDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Parámetros
[in] FunctionalDeviceObject
Puntero a una estructura de DEVICE_OBJECT que representa el objeto de dispositivo funcional WDM para el dispositivo que se está inicializando.
Normalmente, esto se devuelve desde una llamada a IoCreateDevice . Los minidrivers que llaman directamente a esta función son responsables de llamar a IoCreateDevice y asociarse a sí mismos a la pila de dispositivos.
[in] PhysicalDeviceObject
Puntero a una estructura de DEVICE_OBJECT que representa el objeto de dispositivo físico WDM para el dispositivo que se va a inicializar.
[in] NextDeviceObject
Puntero a la siguiente estructura DEVICE_OBJECT de la pila de dispositivos determinada por una llamada a IoAttachDeviceToDeviceStack.
[in, optional] Descriptor
Puntero a una estructura de KSDEVICE_DESCRIPTOR que describe las características del dispositivo que se está inicializando. Si este parámetro es NULL, el dispositivo se inicializa con las características predeterminadas y no tiene generadores de filtros asociados.
Valor devuelto
KsInitializeDevice devuelve STATUS_SUCCESS si el dispositivo se inicializó correctamente. De lo contrario, devuelve un código de error adecuado.
Comentarios
La mayoría de los minidrivers no llaman directamente a esta función. Llame solo a KsInitializeDevice si el minidriver no usa KsInitializeDriver para la inicialización, controla AddDevice de forma independiente y no usa KsAddDevice ni KsCreateDevice en su controlador AddDevice .
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 |