GetPrintProcessorCapabilities 함수(winsplp.h)

인쇄 프로세서의 GetPrintProcessorCapabilities 함수는 지정된 입력 데이터 형식과 연결된 기능을 반환합니다.

통사론

DWORD GetPrintProcessorCapabilities(
  [in]  LPTSTR  pValueName,
  [in]  DWORD   dwAttributes,
  [out] LPBYTE  pData,
  [in]  DWORD   nSize,
  [out] LPDWORD pcbNeeded
);

매개 변수

[in] pValueName

인쇄 프로세서에서 지원하는 데이터 형식을 나타내는 문자열에 대한 호출자 제공 포인터입니다. 문자열 포인터는 LPWSTR 형식이어야 합니다.

[in] dwAttributes

호출자 제공 특성 플래그입니다. PRINTER_INFO_x 구조체의 특성 멤버를 참조하세요.

[out] pData

PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조체에 대한 호출자 제공 포인터입니다.

[in] nSize

pData 가리키는 버퍼의 크기를 나타내는 호출자 제공 값입니다.

값이 sizeof(PRINTPROCESSOR_CAPS_1)보다 작은 경우 이 함수는 인쇄 프로세서에서 지원하는 구조에 따라 sizeof(PRINTPROCESSOR_CAPS_1) 또는 sizeof(PRINTPROCESSOR_CAPS_2)와 같은 값을 제공해야 합니다.

값이 sizeof(PRINTPROCESSOR_CAPS_1)보다 작으면 winprint 인쇄 프로세서에서 sizeof(PRINTPROCESSOR_CAPS_2) 값을 제공합니다.

[out] pcbNeeded

pData 가리키는 버퍼에 필요한 최소 크기를 받을 위치에대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환해야 합니다. 그렇지 않으면 Win32 오류 코드를 반환해야 합니다.

발언

인쇄 프로세서는 선택적으로 GetPrintProcessorCapabilities 함수를 내보낼 수 있습니다. 이 함수의 목적은 인쇄 프로세서에서 지원하는 모든 입력 데이터 형식에 대해 채워진 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조를 반환하는 것입니다.

스풀러는 애플리케이션이 GetPrinterData호출할 때 인쇄 프로세서의 GetPrintProcessorCapabilities 함수를 호출하고, PrintProcCaps_데이터 형식형식으로 값 이름을 지정합니다. 여기서 데이터 형식 입력 데이터 형식의 이름입니다. GetPrintProcessorCapabilities를 호출하기 전에 스풀러가 값 이름 문자열에서 PrintProcCaps_ 접두사를 제거합니다.

함수는 수신된 버퍼가 충분히 큰지 여부를 결정해야 하며, 이 경우 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 구조체를 채우고 반환해야 합니다. nSize 값은 PRINTPROCESSOR_CAPS_1 또는 PRINTPROCESSOR_CAPS_2 사용할지 여부를 결정합니다.

함수는 항상 pcbNeeded 가리키는 위치를 사용하여 실제 버퍼가 충분히 큰지 여부에 관계없이 필요한 버퍼 크기를 반환해야 합니다.

지정한 반환 값은 스풀러가 GetPrinterData 제공하는 반환 값이 됩니다.

요구 사항

요구	값
대상 플랫폼	바탕 화면
헤더	winsplp.h(Winsplp.h 포함)