Função KsAddDevice (ks.h)

A funçãoKsAddDevice é o manipulador de AddDevice padrão instalado pelo KsInitializeDriver.

Sintaxe

KSDDKAPI NTSTATUS KsAddDevice(
  [in] PDRIVER_OBJECT DriverObject,
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

Parâmetros

[in] DriverObject

Um ponteiro para o objeto de driver do WDM para o minidriver.

[in] PhysicalDeviceObject

Um ponteiro para o objeto de dispositivo físico do WDM.

Valor de retorno

Retorna STATUS_SUCCESS indicando que o dispositivo foi criado com êxito ou um status de erro de IoCreateDevice ou KsInitializeDevice.

Observações

Normalmente, um minidriver AVStream não chama essa função diretamente.

Para obter mais informações, consulte Rotina addDevice para minidrivers AVStream.

KsAddDevice extrai o descritor de dispositivo armazenado na extensão de dispositivo alocada de uma chamada para KsInitializeDriver e cria o dispositivo descrito por ele. Se KsInitializeDriver não for usado para inicializar o driver, essa função criará um dispositivo com as características padrão e nenhuma fábrica de filtros. O minidriver sempre tem a opção de chamar KsCreateDevice diretamente, nesse caso, a extensão de driver não é usada pelo AVStream. Como KsAddDevice chama KsCreateDevice, os drivers que chamam KsAddDevice não devem chamar KsCreateDevice separadamente.

Requisitos

Consulte também

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KsCreateDevice

KsDispatchIrp

KsInitializeDevice

KsInitializeDriver