Função WdfIoTargetCreate (wdfiotarget.h)

Artigo
03/22/2025

[Aplica-se a KMDF e UMDF]

O método WdfIoTargetCreate cria um de destino de E/S remoto para um dispositivo especificado.

Sintaxe

NTSTATUS WdfIoTargetCreate(
  [in]           WDFDEVICE              Device,
  [in, optional] PWDF_OBJECT_ATTRIBUTES IoTargetAttributes,
  [out]          WDFIOTARGET            *IoTarget
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in, optional] IoTargetAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que especifica atributos de objeto para o objeto de destino de E/S. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] IoTarget

Um ponteiro para um local que recebe um identificador para um objeto de destino de E/S.

Valor de retorno

WdfIoTargetCreate retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi detectado.
STATUS_INSUFFICIENT_RESOURCES	Não havia memória suficiente para criar um novo objeto de destino de E/S.
STATUS_INVALID_DEVICE_REQUEST	O ParentObject membro da estrutura WDF_OBJECT_ATTRIBUTES que IoTargetAttributes especificado não especificou o objeto de dispositivo da estrutura que dispositivo especificado ou um objeto cuja cadeia de pais leva a esse objeto.

Para obter uma lista de outros valores retornados que o WdfIoTargetCreate pode retornar, consulte Erros de Criação de Objeto da Estrutura.

Esse método também pode retornar outros valores NTSTATUS .

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Depois que um driver chama WdfIoTargetCreate, o driver deve chamar WdfIoTargetOpen antes de enviar solicitações para o destino de E/S remoto.

Se o driver especificar um objeto pai no membro ParentObject da estrutura WDF_OBJECT_ATTRIBUTES, o objeto pai poderá ser um objeto de dispositivo de estrutura ou qualquer objeto cuja cadeia de pais leve a um objeto de dispositivo de estrutura. A estrutura excluirá o objeto de destino de E/S quando ele (ou o driver) excluir o objeto do dispositivo.

Para obter mais informações sobre WdfIoTargetCreate, consulte Inicializando umde destino de E/S geral.

Se o driver fornecer EvtCleanupCallback ou EvtDestroyCallback funções de retorno de chamada para o objeto de destino de E/S, observe que a estrutura chama essas funções de retorno de chamada em IRQL = PASSIVE_LEVEL.

Para obter mais informações sobre destinos de E/S, consulte Usando destinos de E/S.

Exemplos

Para obter um exemplo de código que usa WdfIoTargetCreate, consulte WdfIoTargetOpen.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdfiotarget.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WDF_OBJECT_ATTRIBUTES

WdfIoTargetOpen

Partilhar via