Função KsAddDevice (ks.h)
A função KsAddDevice é o manipulador 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 WDM para o minidriver.
[in] PhysicalDeviceObject
Um ponteiro para o objeto de dispositivo físico do WDM.
Retornar valor
Retorna STATUS_SUCCESS indicando que o dispositivo foi criado com êxito ou um erro status de IoCreateDevice ou KsInitializeDevice.
Comentários
Normalmente, um minidriver AVStream não chama essa função diretamente.
Para obter mais informações, consulte AddDevice Routine for AVStream Minidrivers.
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, caso em que 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
| 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 |