IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace-Methode (prcomoem.h)

Die IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace Methode fragt das Gerät nach dem standardmäßigen URI (Uniform Resource Identifier) des Namespaces ab.

Syntax

HRESULT QueryDeviceDefaultNamespace(
  [out] OUT BSTR *pbstrNamespaceUri
);

Parameter

[out] pbstrNamespaceUri

Ein Zeiger auf einen BSTR, der den Namespace-URI empfängt. Das Plug-In platziert den Namespace-URI im Puffer, auf den pbstrNamespaceUriverweist. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace ist für die Zuweisung der Zeichenfolge durch einen Aufruf von SysAllocString (in der Microsoft Windows SDK-Dokumentation beschrieben) verantwortlich, der Aufrufer ist jedoch dafür verantwortlich, die Zeichenfolge freizuweisen.

Rückgabewert

IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace einen der folgenden Werte zurückgeben.

Bemerkungen

Das Plug-In sollte den Namen des privaten Namespace-URI angeben, den der Kerntreiber verwenden soll, um alle Features zu behandeln, die in der GPD-Datei oder PPD-Datei definiert sind, die der Kerntreiber nicht erkennt. Das Plug-In kann einen Satz von Namespaces als Ergebnis des Aufrufs der IPrintOemPrintTicketProvider::BindPrintEr-Methode angeben. Der Zweck des IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace besteht darin, den Kerntreiber darüber zu informieren, welche dieser Namespaces als Standardnamespace verwendet werden sollen. Der Haupttreiber ordnet alle Features zu, die nicht mit diesem Standardnamespace erkannt werden, und platziert solche Features im Druckticket.

Wenn IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace zurückgibt, ist der Kerntreiber für das Hinzufügen des privaten Namespace-URI verantwortlich, den das Plug-In (in *pbstrNamespaceUri) dem Stammknoten des DOM-Dokuments angegeben hat. Der Kerntreiber muss auch ein Präfix für den privaten Namespace definieren, den das Plug-In verwenden soll, wenn das Plug-In dem Druckticket unter dem privaten Namespace des Plug-Ins einen neuen Knoten hinzufügt. Das Plug-In sollte kein eigenes Präfix für diesen standardmäßigen privaten Namespace-URI definieren.

Anforderungen

Siehe auch

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter