Função de retorno de chamada PFNKSDEVICEPNPSTART (ks.h)

Artigo
02/07/2025

Uma rotina de do AVStrMiniDeviceStart de um minidriver AVStream é chamada quando uma solicitação de IRP_MN_START_DEVICE é enviada para um dispositivo especificado.

Sintaxe

PFNKSDEVICEPNPSTART Pfnksdevicepnpstart;

NTSTATUS Pfnksdevicepnpstart(
  [in]           PKSDEVICE Device,
  [in]           PIRP Irp,
  [in, optional] PCM_RESOURCE_LIST TranslatedResourceList,
  [in, optional] PCM_RESOURCE_LIST UntranslatedResourceList
)
{...}

Parâmetros

[in] Device

Ponteiro para uma estrutura KSDEVICE que descreve o dispositivo a ser iniciado.

[in] Irp

Ponteiro para o IRP_MN_START_DEVICE que foi recebido.

[in, optional] TranslatedResourceList

Ponteiro para uma estrutura de CM_RESOURCE_LIST que contém a lista de recursos traduzida extraída de irp. É igual a NULL se Device não tiver recursos atribuídos. Opcional.

[in, optional] UntranslatedResourceList

Ponteiro para uma estrutura de CM_RESOURCE_LIST que contém a lista de recursos não traduzidas extraída de irp. É igual a NULL se o KSDEVICE membro dessa lista de parâmetros não tiver recursos atribuídos. Opcional.

Valor de retorno

Deve retornar STATUS_SUCCESS ou o código de erro retornado da tentativa de executar a operação. A inicialização será garantida para ter êxito se a rotina retornar um código de status bem-sucedido. NÃO retorne STATUS_PENDING.

Observações

Especifique o endereço dessa rotina no membro Iniciar de sua estrutura de KSDEVICE_DISPATCH.

Normalmente, essa rotina é usada por minidrivers que devem avaliar os recursos atribuídos. As listas de recursos são extraídas de irp para a conveniência do minidriver. Um minidriver pode analisar a lista de recursos para localizar a interrupção atribuída ao dispositivo, bem como o endereço físico dos recursos de memória.

Os minidrivers podem usar essa rotina para alocar informações de contexto para associar ao dispositivo AVStream. (Isso é semelhante a um minidriver em classe de fluxo usando a extensão do dispositivo para armazenar informações de contexto.)

Observe que STATUS_PENDING não é um código de retorno legal dessa função. Para executar ações no contexto de um thread de trabalho antes que o AVStream conclua as ações de início, como habilitar interfaces de dispositivo, use uma expedição pós-início. Consulte AVStrMiniDevicePostStart.

Essa rotina é opcional.

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	Área de trabalho
cabeçalho	ks.h (incluir Ks.h)

Consulte também

CM_RESOURCE_LIST

KSDEVICE_DISPATCH

Compartilhar via