Função KsInitializeDriver (ks.h)
A função KsInitializeDriver inicializa o objeto de 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 DRIVER_OBJECT para o driver AVStream que está sendo inicializado. 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 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.
Retornar valor
KsInitializeDriver retorna STATUS_SUCCESS ou um código de erro apropriado, conforme retornado por IoCreateDevice ou rotinas internas de inicialização do dispositivo AVStream.
Comentários
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 no momento de AddDevice . Minidrivers que executam a inicialização do dispositivo por conta própria não precisam necessariamente chamar KsInitializeDriver. Para obter mais informações, consulte Inicializando um minidriver AVStream.
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 |