Método IWDFFile3::GetInitiatorProcessId (wudfddi.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método GetInitiatorProcessId recupera el identificador de proceso del iniciador asociado a una interfaz IWDFFile .

Sintaxis

void GetInitiatorProcessId(
  [out] DWORD *pdwProcessId
);

Parámetros

[out] pdwProcessId

Especifica la dirección de una ubicación que recibe el identificador de proceso del iniciador asociado al archivo, si existe alguno. De lo contrario, la ubicación recibe 0.

Valor devuelto

None

Observaciones

A partir de Windows 8, un componente del sistema puede emitir una creación en nombre de una aplicación. El controlador puede llamar a GetInitiatorProcessId para determinar el proceso para el que se pretende en última instancia la operación de creación.

GetInitiatorProcessId devuelve cero si no hay ningún proceso iniciador asociado a la operación de creación.

Para obtener más información sobre los objetos de archivo de marco, vea Driver-Created Versus Application-Created File Objects.

Ejemplos

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 Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.11
Encabezado wudfddi.h (incluya Wudfddi.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFFile3