Função de retorno de chamada PFNKSDEVICECREATE (ks.h)
A rotina AVStrMiniDeviceAdd de um minidriver AVStream notifica o minidriver que a rotina de AddDevice PnP da AVStream foi concluída.
Sintaxe
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parâmetros
[in] Device
Ponteiro para uma estrutura KSDEVICE que descreve o FDO (objeto de dispositivo funcional) que acabou de ser criado.
Retornar valor
Deve retornar STATUS_SUCCESS ou o código de erro retornado da tentativa de executar a operação. Se o minidriver retornar status de falha, a chamada addDevice relacionada também falhará. Consulte a seção Comentários abaixo para obter mais detalhes.
Comentários
O minidriver especifica o endereço dessa rotina no membro Add de sua estrutura KSDEVICE_DISPATCH .
O AVStream chama AVStrMiniDeviceAdd de sua rotina padrão de AddDevice , no momento da inicialização do KSDEVICE . No ponto em que essa rotina é chamada, o objeto de dispositivo WDM (DEVICE_OBJECT) foi criado, a estrutura KSDEVICE foi instanciada e inicializada e o cabeçalho do dispositivo KS foi alocado.
Os minidrivers podem usar essa rotina para associar informações de contexto ao objeto de dispositivo AVStream ou para inicializar uma extensão de dispositivo.
Se essa rotina retornar um código de status malsucedido, a rotina AddDevice do AVStream falhará. STATUS_PENDING não é um código de devolução legal porque nenhum IRP está envolvido. A rotina é chamada em IRQL = somente PASSIVE_LEVEL.
Essa rotina é opcional.
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 | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |