Função KsInitializeDriver (ks.h)
A função KsInitializeDriver inicializa o objeto driver de um minidriver AVStream.
Sintaxe
KSDDKAPI NTSTATUS KsInitializeDriver(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPathName,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Parâmetros
[in] DriverObject
Um ponteiro para a estrutura de DRIVER_OBJECT para o driver AVStream que está sendo inicializado. Os minidrivers que chamam KsInitializeDriver devem usar o objeto driver passado para DriverEntry pelo sistema operacional.
[in] RegistryPathName
Um ponteiro para uma cadeia de caracteres Unicode que contém a cadeia de caracteres de caminho do registro passada para a função DriverEntry do minidriver pelo sistema operacional.
[in, optional] Descriptor
Um ponteiro para uma estrutura de KSDEVICE_DESCRIPTOR que especifica as características do dispositivo que está sendo inicializado. Se esse ponteiro for NULL, um dispositivo será criado com características padrão e nenhuma fábrica de filtros associada.
Valor de retorno
KsInitializeDriver retorna STATUS_SUCCESS ou um código de erro apropriado, conforme retornado por IoCreateDevice ou rotinas internas de inicialização do dispositivo AVStream.
Observações
Essa função normalmente é chamada de DriverEntry. Se o minidriver passar em um descritor de dispositivo, o AVStream criará um dispositivo com as características especificadas em addDevice tempo. Os minidrivers que executam a inicialização do dispositivo em si não precisam necessariamente chamar do KsInitializeDriver. Para obter mais informações, consulte Inicializando um minidriver AVStream.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |