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 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 sem fábricas de filtros associadas.

Valor retornado

O KsInitializeDriver retorna STATUS_SUCCESS ou um código de erro apropriado, conforme retornado por IoCreateDevice ou rotinas internas de inicialização de dispositivo AVStream.

Comentários

Essa função normalmente é chamada do DriverEntry. Se o minidriver passar em um descritor de dispositivo, o AVStream criará um dispositivo com as características especificadas no momento do AddDevice . Os minidrivers que executam a inicialização do dispositivo em si não precisam necessariamente chamar o KsInitializeDriver. Para obter mais informações, consulte Inicializando um Minidriver AVStream.

Requisitos

   
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

Confira também

DEVICE_OBJECT

DRIVER_OBJECT

DriverEntry do AVStream

IoCreateDevice

KSDEVICE_DESCRIPTOR

KSDEVICE_DISPATCH

KSFILTER_DESCRIPTOR

KsInitializeDevice