Método IWDFFile3::GetInitiatorProcessId (wudfddi.h)
[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 |