Método IWDFFile3::GetInitiatorProcessId (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 GetInitiatorProcessId recupera a ID do processo iniciador associada a uma interface IWDFFile .

Sintaxe

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Parâmetros

[out] pdwProcessId

Especifica o endereço de um local que recebe o identificador de processo iniciador associado ao arquivo, se houver. Caso contrário, o local receberá 0.

Retornar valor

Nenhum

Comentários

A partir do Windows 8, um componente do sistema pode emitir uma criação em nome de um aplicativo. O driver pode chamar GetInitiatorProcessId para determinar para qual processo a operação de criação se destina.

GetInitiatorProcessId retornará zero se nenhum processo iniciador estiver associado à operação de criação.

Para obter mais informações sobre objetos de arquivo de estrutura, consulte Driver-Created Versus Application-Created File Objects.

Exemplos

VOID
STDMETHODCALLTYPE
CMyQueue::OnCreateFile(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in IWDFFile*  pWdfFileObject
    )
 ...
    IWDFFile3*  pWdfFileObject3 = NULL;
    HRESULT  hr = S_OK;
    DWORD initiatorProcessId;

    //
    // Obtain IWDFFile3 interface from IWDFFile.
    //
    hr = pWdfFileObject->QueryInterface(IID_PPV_ARGS(&pWdfFileObject3));
    if (!SUCCEEDED(hr))
    {
        goto Done;
    }
    pWdfFileObject3->GetInitiatorProcessId(&initiatorProcessId);
    ...

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.11
Cabeçalho	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Confira também

IWDFFile3