Método IWDFDevice2::CreateRemoteTarget (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método CreateRemoteTarget cria um objeto de destino remoto que representa um 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 de 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.
Retornar valor
CreateRemoteTarget retornará S_OK se a operação for bem-sucedida. Caso contrário, o método poderá retornar o seguinte valor:
| Código de retorno | Descrição |
|---|---|
|
Falha na tentativa da estrutura de alocar memória. |
|
O parâmetro pParentObject não especificou o objeto de dispositivo que fornece a interface IWDFDevice2 ou um objeto cuja cadeia de pais leva a esse objeto. |
Esse método pode retornar um dos outros valores que Winerror.h contém.
Comentários
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 usa o parâmetro pParentObject para especificar um objeto pai, o objeto pai pode ser o objeto do dispositivo que fornece a interface IWDFDevice2 ou pode ser qualquer objeto cuja cadeia de pais leva 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 de E/S remotos, consulte Usando destinos de E/S no UMDF.
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. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1,9 |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |