通过

打印筛选器中的异步通知

  • 项目

重要

新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验，以便进行打印机设备开发。

有关详细信息，请参阅新式打印平台和打印支持应用设计指南。

打印筛选器管道具有异步通知功能，此功能与应用程序打印后台处理程序中支持的异步通知功能非常相似。 打印后台处理程序中可用的 RouterCreatePrintAsyncNotificationChannel 函数不适用于打印筛选器。 打印过滤器必须使用 IPrintClassObjectFactory 接口来创建 IPrintAsyncNotify 对象。

本主题介绍如何在打印筛选器中使用异步通知功能。

v4 打印驱动程序模型不支持从打印筛选器引发异步通知。

IPrintClassObjectFactory

IPrintClassObjectFactory 接口提供对通知接口的访问权限。 以下代码示例说明了筛选器如何从属性包中获取该接口。

// This interface is defined as a private member variable in the filter class
IPrintClassObjectFactory  *m_pPrintClassFactory;

// The following code goes in the IntializeFilter method of the filter
VARIANT var;
VariantInit(&var);

HRESULT hr = pIPropertyBag->GetProperty(
    XPS_FP_PRINT_CLASS_FACTORY,
    &var);

if (SUCCEEDED(hr))
{
    hr = V_UNKNOWN(&var)->QueryInterface(
 IID_IPrintClassObjectFactory,
 reinterpret_cast<void **>(&m_pPrintClassFactory));
}

通知通道

通过 IPrintClassObjectFactory 接口，筛选器可以根据需要创建单向或双向通知通道。 以下代码示例延续了前面的示例，展示了筛选器如何建立单向通知通道。

// Create a unidirectional notification channel
IPrintAsyncNotifyChannel  *pIAsyncNotifyChannel;
IPrintAsyncNotify  *pIAsyncNotify;

HRESULT hr = m_pPrintClassFactory->GetPrintClassObject(
 m_bstrPrinter,      // The printer name that was read from the property bag
 IID_IPrintAsyncNotify,
 reinterpret_cast<void**>(&pIAsyncNotify)));

if (SUCCEEDED(hr))
{
    hr = pIAsyncNotify->CreatePrintAsyncNotifyChannel(
 m_jobId,
 const_cast<GUID*>(&MS_ASYNCNOTIFY_UI),
 kPerUser,
 kUniDirectional,
        NULL,
        &pIAsyncNotifyChannel));

   // etc...
}

要创建双向通知通道，可以使用下面的代码示例代替前面的示例。

// Create a bidirectional notification channel
IPrintAsyncNotifyChannel *pIAsyncNotifyChannel;
IPrintAsyncNotify *pIAsyncNotify;

HRESULT hr = m_pPrintClassFactory->GetPrintClassObject(
 m_bstrPrinterName,   // The printer name that was read from the property bag
 IID_IPrintAsyncNotify,
 reinterpret_cast<void**>(&pIAsyncNotify)));

if (SUCCEEDED(hr))
{
    hr = pIAsyncNotify->CreatePrintAsyncNotifyChannel(
 m_jobId,
 const_cast<GUID*>(& SAMPLE_ASYNCNOTIFY_UI),
 kPerUser,
 kBiDirectional,
 pIAsyncCallback,
        &pIAsyncNotifyChannel));

    // etc...
}

在前面的代码示例中，变量 pIAsyncCallback 是指向调用方实现 IPrintAsyncNotifyCallback 接口的指针。

在某些情况下，双向通知通道使用完毕后必须释放。 为此，请调用 IPrintAsyncNotifyChannel 上的 Release 方法。 有关何时释放通道的信息，请参阅通知通道。

模拟和通知

筛选器在调用 IPrintAsyncNotify::CreatePrintAsyncNotifyChannel 方法时不得模拟用户帐户。 打印后台处理程序中的授权机制要求从本地服务帐户进行调用。 如果筛选器必须模拟提交作业的用户的帐户，则筛选器必须在调用 CreatePrintAsyncNotifyChannel 之前还原为自身。 调用返回后，如有必要，筛选器可以还原用户帐户。

尽管通知调用是在本地服务上下文中进行的，但 kPerUser 通知仍会根据作业 ID 的用户关联发送给提交作业的用户。

调整 WDK 示例代码

可以用以下代码示例替换 RouterCreatePrintAsyncNotificationChannel 调用，从而调整 WDK 示例代码中的通知示例，使其适用于打印筛选器。

IPrintAsyncNotify  *pIAsyncNotify;

HRESULT hr = m_pPrintClassFactory->GetPrintClassObject(
 m_bstrPrinterName,      // get it from the property bag
 IID_IPrintAsyncNotify,
 reinterpret_cast<void**>(&pIAsyncNotify)));

if (SUCCEEDED(hr))
{
    hr = pIAsyncNotify->CreatePrintAsyncNotifyChannel(
 // the same arguments as for
 // RouterCreatePrintAsyncNotificationChannel
        );

    // etc...
}