GPUDevice：createComputePipelineAsync() 方法

語法

createComputePipelineAsync(descriptor)

引數

描述符（descriptor）

請參閱 GPUDevice.createComputePipeline() 方法的描述符定義。

返回值

當建立的流水線準備好被使用而無需額外延遲時，返回的 Promise 會以一個 GPUComputePipeline 物件例項 fulfilled。

驗證

如果流水線建立失敗，導致流水線無效，則返回的 Promise 會以一個 GPUPipelineError reject。

• 如果這是由於內部錯誤，則 GPUPipelineError 的 reason 為 "internal"。
• 如果這是由於驗證錯誤，則 GPUPipelineError 的 reason 為 "validation"。

如果以下任一條件不滿足，則可能發生驗證錯誤：

• compute 屬性中引用的 module 使用的工作組儲存大小小於或等於 GPUDevice 的 maxComputeWorkgroupStorageSize 限制。
• module 每個工作組使用的計算呼叫次數小於或等於 GPUDevice 的 maxComputeInvocationsPerWorkgroup 限制。
• module 的工作組大小小於或等於 GPUDevice 相應的 maxComputeWorkgroupSizeX、maxComputeWorkgroupSizeY 或 maxComputeWorkgroupSizeZ 限制。
• 如果省略了 entryPoint 屬性，則著色器程式碼包含一個用於瀏覽器作為預設入口點使用的計算著色器入口點函式。

示例

基本示例

以下示例展示了一個過程：

• 使用 GPUDevice.createBindGroupLayout() 建立繫結組佈局。
• 將 bindGroupLayout 輸入到 GPUDevice.createPipelineLayout() 中以建立 GPUPipelineLayout。
• 在 createComputePipelineAsync() 呼叫中立即使用該值建立 GPUComputePipeline。

async function init() {
  // …

  const bindGroupLayout = device.createBindGroupLayout({
    entries: [
      {
        binding: 0,
        visibility: GPUShaderStage.COMPUTE,
        buffer: {
          type: "storage",
        },
      },
    ],
  });

  const computePipeline = await device.createComputePipelineAsync({
    layout: device.createPipelineLayout({
      bindGroupLayouts: [bindGroupLayout],
    }),
    compute: {
      module: shaderModule,
      entryPoint: "main",
    },
  });

  // …
}

規範

瀏覽器相容性

另見

• WebGPU API