Função KsInitializeDevice (ks.h)

Artigo
02/26/2024

A função KsInitializeDevice é chamada pelo AVStream para inicializar a classe de dispositivo AVStream de dentro de KsCreateDevice.

Sintaxe

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

Um ponteiro para uma estrutura DEVICE_OBJECT que representa o objeto de dispositivo funcional WDM para o dispositivo que está sendo inicializado.

Normalmente, isso é retornado de uma chamada IoCreateDevice . Os minidrivers que chamam essa função diretamente são responsáveis por chamar IoCreateDevice e se anexar à pilha do dispositivo.

[in] PhysicalDeviceObject

Um ponteiro para uma estrutura DEVICE_OBJECT que representa o objeto de dispositivo físico WDM para o dispositivo que está sendo inicializado.

[in] NextDeviceObject

Um ponteiro para a próxima estrutura DEVICE_OBJECT na pilha do dispositivo, conforme determinado por uma chamada para IoAttachDeviceToDeviceStack.

[in, optional] Descriptor

Um ponteiro para uma estrutura KSDEVICE_DESCRIPTOR que descreve as características do dispositivo que está sendo inicializado. Se esse parâmetro for NULL, o dispositivo será inicializado com as características padrão e não terá fábricas de filtros associadas.

Retornar valor

KsInitializeDevice retornará STATUS_SUCCESS se o dispositivo tiver sido inicializado com êxito. Caso contrário, ele retornará um código de erro apropriado.

Comentários

A maioria dos minidrivers não chama essa função diretamente. Chame KsInitializeDevice somente se o minidriver não usar KsInitializeDriver para inicialização, manipular AddDevice de forma independente e não usar KsAddDevice ou KsCreateDevice em seu manipulador AddDevice .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX.
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
Biblioteca	Ks.lib
IRQL	PASSIVE_LEVEL