Método IWDFDevice2::CreateRemoteTarget (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
O método CreateRemoteTarget cria um objeto de destino remoto que representa um de destino de E/S remoto.
Sintaxe
HRESULT CreateRemoteTarget(
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFRemoteTarget **ppRemoteTarget
);
Parâmetros
[in, optional] pCallbackInterface
Um ponteiro para uma interface de retorno de chamada opcional fornecida pelo driver. O método IUnknown::QueryInterface dessa interface deve retornar um ponteiro para a interface IRemoteTargetCallbackRemoval do driver, se o driver der suporte a essa interface. Esse parâmetro é opcional e pode ser NULL.
[in, optional] pParentObject
Um ponteiro para um objeto de estrutura. Se o driver fornecer esse ponteiro opcional, o objeto especificado se tornará o pai do novo objeto de destino remoto. Se esse parâmetro for NULL, o objeto do dispositivo que fornece a interface IWDFDevice2 se tornará o pai. A estrutura excluirá o objeto de destino remoto quando excluir o objeto pai.
[out] ppRemoteTarget
Um ponteiro para um local que recebe um ponteiro para a interface IWDFRemoteTarget do novo objeto de destino remoto.
Valor de retorno
CreateRemoteTarget retornará S_OK se a operação for bem-sucedida. Caso contrário, o método poderá retornar o seguinte valor:
Esse método pode retornar um dos outros valores que Winerror.h contém.
Observações
Depois que o driver chamar CreateRemoteTarget, o driver poderá abrir o destino remoto chamando IWDFRemoteTarget::OpenRemoteInterface (para abrir uma interface de dispositivo ) ou IWDFRemoteTarget::OpenFileByName (para abrir um arquivo).
Se o driver usar o parâmetro pParentObject para especificar um objeto pai, o objeto pai poderá ser o objeto do dispositivo que fornece a interface de IWDFDevice2 ou pode ser qualquer objeto cuja cadeia de pais leve a esse objeto de dispositivo. A estrutura excluirá o objeto de destino remoto quando ele (ou o driver) excluir o objeto do dispositivo.
Para obter mais informações sobre destinos remotos de E/S, consulte Usando destinos de E/S noUMDF.
Exemplos
Para obter exemplos de código que usam CreateRemoteTarget, consulte os exemplos de código em IWDFDevice2::CreateRemoteInterface e IWDFRemoteTarget::OpenFileByName.
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |