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